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Intersoft is not a large company/ we are a group of 
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software for as low a price as we can manage. There is little 
that we can do to prevent software piracy other than to request 
that you* our fellow programmers* refrain from this common 
practice. 



Please report any inaccuracies in the documentation by 
completing and returning the "Reader Comments" form included at 
the end of the Programmer's Manual. 



Intersoft C v2.5 



Table of Contents 



CONTENTS 

Disk Contents .•••••••••••••••••• •- . • 4 

Checkout Procedure ..-.-..-..------••••5 

Special Notes • •••.••••••••••••-•••>7 

I/O Devices ....„........-.---- ••••9 

Interfacing to non-C code ..•.-.••--•••••.10 

Special functions ...... • •••••.••••••• 13 

Splits Merge and Extract •••••••«••••••••• 15 

User Registration •••••.•••••••••••••• 17 



I nt erso f t C v2. 5 



Disk Content s 



DISK CONTENTS 



Disk #1: 

C/CMD ...... The C compiler 

CLI8/REL . . . - . Linker library of run time support 
STDIO/H ..... The standard I/O constants file 

RUNLIB/MAC .... The 16-bit run time support 

CPY/C .••••• Source for the copy program 

README/TXT . . . . Final notes 



functions 



Disk nil 

IO/H .....•• Constants and 

OS/H ....... Constants and 

PRINTF/H . . . . . Constants and 

SCANF/H ..... Constants and 

IO/C ....... I/O support so 

OS/C .......OS support sou 

PRINTF/C ..... printfO* fpri 

source library 
SCANF/C ..... scanfO/ fscan 

source library 
STD1/C •••••• Miscellaneous 

STD2/C ...... Miscellaneous 

STD3/C ...... Miscellaneous 

PROLOG/MAC .... Assembler prol 

EPILOG/MAC .... Routines to ca 

MERGE/C • • . • • Source for the 
SPLIT/C ..... Source for the 

EXTRACT/C .... Source for ext 



globals for "IO/C" 

globals for "OS/C" 

globals for "PRINTF/C" 

globals for "SCANF/C" 

urce library 

rce I ib ra ry 

nt f ( ) and sprint f O 

f ( ) and sscanf () 

support source library 1 
support source library 2 
support source library 3 
ogue for all C programs 
11 the Operating System 

merge program 

split program 
ract program 



The compiler source (if ordered) resides on disks #3 and #4 
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CHECKOUT PROCEDURE 

1) If you are wise you will back up the distribution disks 
immedi ately . 



2) - Make a system disk for C compilations containing 
the following files from the distribution disks: 



C/CMD 

STDIO/H 

CPY/C 

We recommend that you kill all non-essential files 
from this system disk and attempt to add your editor 
to the disk. For information on what files you 
don f t need on your system disk consult your DOS 
manual. Eg. For TRSOOS 2.3 the files BASIC/CMD* 
BASICR/CMD and FORMAT/CMD may be removed; their 
passwords are BASIC* BASIC and FORMAT respectively. 

- Make a second system disk containing the Microsoft M80 
assembler/ L80 linker and the file CLIB/REL from the 
distribution disks. 

- Make a data diskette to containing the file CPY/C from 
the distribution disks. 

3) With the first system disk prepared in step 2) in 
drive 0: and the data diskette in drive 1: type the 
following command: 

C CPY/C:1 0=CPY/MAC:1 

- At this point load the second system disk prepared 
in step 2) into drive 0:# then type: 

M80 CPY:1=CPY:1 

KILL CPY/MAC:1 

L80 CPY:1#CLIB-S,-U*CPY:1-N-E:CCMAIN 

KILL CPY/REL:1 

This illustrates the normal sequence of compiling* 
assembling and linking a C program. Compiler options 
are described in the section of the Programmer's 
manual titled "How to use the Compiler". 
The library module "CLI8" must be included in the link 
line or there will be unresolved external references. 
All Intersoft C programs begin execution at the label 
"CCMAIN". 

If the compiler* assembler or linker report errors then 
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retry the process recording what you typed and what 
errors were reported before contacting the retailer. 

4) Type the command: 
CPY:1 

Now type some lines. You will find that the TRS80 line 
editing commands will work. All the program does 
in this form is echo what was typed. 

The full abilities of this program are explained in 
the section of the Programmer's manual titled "Sample C 
Programs". To terminate the program press BREAK to enter 
an End of File code for *BI. It is possible that the 
BREAK key will not enter an End of File under some versions 
of TRSDOS. If the BREAK key does not terminate the CPY 
program under your DOS please refer to note 14) in the 
"Special Notes" section of this manual. 



The compiler is undamaged if you are able to complete these 
four steps. The remainder of the files on the distribution 
disks are not used during normal C compilations. The source 
code for all of the run time support functions (and the compiler 
source if it was ordered) have been provided to allow you to 
customize the compiler. 



Intersof t C v2.5 



Speci at Not es 



SPECIAL NOTES FOR THE TRS80 MODEL I IMPLEMENTATION 



1) Only the first six characters of global symbol names are 
significant with the MACRO80 assembler, 

2) The TRS80 version of the compiler uses the restart vectors 
3 and 4. If these restart vectors are unavailable on 
your machine then the compiler will not work correctly. 

3) There are no default extensions for either the input or 
output files to the compiler. 

4) Do not specify the same input and output file name to the 
compiler. The file will be overwritten by the output of 
the compiler faster than the file is read for input to the 
compiler. This will eventually cause the compiler to 
attempt to compile its own output. 

5) The function call "exit(n)" will abort a "Chain" or "DO" 
file in progress if "n" is non-zero. 

6) The buffered keyboard device (*BI) cannot be re-opened 
when it is already open. 

7) The function call "feof(fp)" checks for End of File by 
examining the file error code (returned by ferror(fp)) to 

see if it is OxICOO (End of File) or OxlDOO (No Record Found). 

When reconfiguring the compiler for a different DOS be certain 

to verify that these constants are adjusted to reflect the new 
DOS' conventions. 

8) All internal labels used by the compiler and run time support 
functions are prefixed with "cc". Function and variable names 
should not begin with "cc" or name clashes might result. 

9) The maximum number of simultaneously open files is 14. 

10) The special functions "read" and "write" supplied with the 
TRS80 version do not have the standard arguments as outlined 
in the book by Kernighan and Ritchie. Both these functions 
require that the file be opened and closed via fopenO and 
fcloseO rather than openO and closeO. The reason for this 
is that Intersoft C does not yet have the openO and closeO 

f unc tions. 

11) There are two significant differences between the TRS80 
Model I and Model III. If you attempt to move the 
compiler to a Model III system then the address of the top of 
memory pointer must be changed in IO/H and the meminiO 
function of OS/C. The address is 0x4049 on the Model I. 

The address of the DOS command line should be changed in IO/H 
if necessary. The address is 0x4318 on the Model I. 
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12) If your application requires extremely fast i/o you can 
make use of the following (non-standard) functions from 
IO/C: 

codvr, prdvr, keydvr* bufdvr* ccoutput/ ccinput/ ccatput/ 
ccatget* ccfspec* ccpeof* ccinit* ccopen and ccclos. 

None of these functions are portable to other implementations 
of C. All of these functions should be used with extreme 
caut ion. 

13) The source for all the functions in the linker library has 
been provided with the compiler. Frequently* groups of 
functions have been collected into a simple form of source 
library. Whenever functions have been collected into a 
source library they have been put into the source library 

in the order in which they were put into the linker library. 
The ordering of source files and libraries as they went into 
the linker library is: 

prolog/mac* scanf/c/ printf/c* std1/c# io/c# std2/c* os/c# 
std3/c* runlib/mac and epilog/mac. 



14) The End of File code for the device *BI (buffered keyboard 
input) is normally the BREAK key. It is possible that your 
DOS has disabled the BREAK key. If this is so we recommend 
that you code programs so that they use some other method 
of terminating other than checking for End of File from the 
*8I device. Eg: use the strings "stop" or "end" to indicate 
that the program should be terminated. 

15) The End of File code for the device *CI (unbuffered 
keyboard input) is normally the control-z key. Under LDOS 
this corresponds to pressing the shift* down-arrow and 

Z keys simultaneously. Under TRSDOS this usually corresponds 
to pressing the shift and down-arrow keys simultaneously. 
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I/O DEVICES 

Intersoft C supports the following devices* they may be 
used as file names to the "fopen" function: 



Name 



Descr ipt i on 



*BI Buffered console input* 

*CI Unbuffered console input. 

*C0 Unbuffered console output. 

•PR Unbuffered printer output. 

The "fopen" function will only allow a device to be opened 
for its intended purpose. Eg: *BI must be opened with a mode of 
"r" m The output devices may be opened for either write ("w") or 
append <"a"). The device names may be given in upper or lower 
case/ "fopen" is insensitive to the case of its arguments. To 
enter an end of file code for *BI press BREAK. To enter an end 
of file code for *CI press BREAK or control-Z. It is possible 
that your DOS disables the BREAK key. If so then you will find 
this out when you perform the acceptance procedure outlined in 
this manual. 



Intersoft C v2.5 



10 



Interfacing to non-C code 



INTERFACING TO NON-C CODE 



The compi ler 
whi ch permit s s 
languages- The 
code is by means 

C code can c 
the code it co 
compat ibi I i ty. T 
value passing mus 

C evaluates 
pushes the values 
arguments is lo 
used during compi 
argument is store 



generates code 

imple interfaci 

pref e r red me th 

of function call 

all a f unct ion w 

ntains: there 

he only restrict 

t be compatible. 

function argun 

on the stack as 

aded into regis 

lat ion) and th 

d as two bytes r 



in highly predictable patterns/ 
ng to code written in other 
od of interfacing to "foreign" 
s. 
ithout knowing the nature of 

is no checking for argument 
ion is that argument and return 

ents from left to right/ and 
they occur. Next the number of 
ter A (unless the "-n" option is 
e function is called. Every 
egardless of its actual size. 



Ca I ling 

somef unc (a*b)/ 
results in the following machine state on entry to the function: 



SP+A 
SP + 2 
SP 



J 
> I 



I 



> I b I 
•> I return addr. I 



Register A contains the value 2 (unless the "-n" option was 
used during compilation). 

In the above example/ if "somefunc" were an assembler 

routine/ the values of the parameters could be found by applying 

an offset to the stack pointer. For example/ we could fetch the 
value of b by one of the following code sequences. 

; fetch the address of the variable 

LD HL/2 Joffset in bytes from the CURRENT 

Jstack pointer 

ADD HL/SP ;actual address into HL 
§ 
; now fetch the integer value into HL 

LD A/(HL) 

INC HL 

LD H/(HL) 

LD L/A 



or 
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Interfacing to non-C code 



LD HL*4 
CALL CC6IS 



;the variable's stack offset + 2 
;one of the compiler's 16-bit support 
; rout i nes. 



After any C function call code is generated to reclaim the 
stack space used by the parameters. 

The result of the function call (the returned value) is 
assumed to be in the register pair HL. 



The #asm Preprocessor Directive 



This preprocessor 
assembly code within 
provide as "clean" an 
it is useful at times. 

The "#asm" direct 
without processing) d 
occu ranee of the fi 
compi ler will not r 
declarations or prep 
within a "#asm" block. 
"#asm" block is not 
"fldefine") will not be 



direct i ve 
a C fun 
interface a 

ive causes 
i r ect ly to 



rst 



#enda 



ecogni se a 
rocessor d 

Please 
pr eprocesse 
expanded. 



may be used to insert in-line 
ction. Although this does not 
s calling assembler functions* 

the source file to be copied ( 
the output file up to the 
sm" preprocessor directive. The 
ny data definitions* function 
irectives (other than "tfendasm") 
note that the text within a 
d* therefore macros (defined via 
Further restrictions arei 



- A "#asm" block may not occur inside a simple statement 
or expression. 

- The stack pointer must be the same on exit as it was 
upon entry to the "#asm" block. 

In order to access variables* including stack variables and 
function parameters* it is possible to make use of the fact that 
the code generator leaves the result of the last expression in 
the register pair HL. The following example doubles the value 
of "i" and stores it in "j": 

funcO I 
i n t i * j ; 

i; /* Gets "i" into the register pair HL */ 
ft asm 

ADD HL*HL ;Double the register pair HL. 

EX DE*HL ;Save the result in the register pair DE. 
ffendasm 

&j; /* Gets the address of "j" into HL */ 
#asm 

LD (HL)*E ;Store the low byte. 

INC HL 

LD (HL)*D ;store the high byte, 
tfendasm 
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A valid use for a "//asm" block within a function containing 
C code is to access the number of arguments passed to a 
function. Examples of this are the listings of the functions 
printf/ fprintf and sprintf in the "Sample C programs" section 
of the Programmer's manual. 
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SPECIAL FUNCTIONS 

In addition to the functions listed in the section of the 
Programmer's manual titled "Run Time Support Functions"/ your 
run time support library contains some functions specifically 
oriented to TRS80 Model 1 machines. 

If you wish to change any of the run time support functions 
we strongly suggest that you make a library or module of your 
changed functions and link it before searching the supplied 
library* rather than actually changing the supplied library. 



The following is a list of the 
functions (in alphabetical order): 



special run time support 



clearerr(fp) - Remove an error condition on a file* 



This 
inval id. 
returned 

attempts at I/O. 
of the error. 



function returns EOF if the file pointer <fp) is 

Otherwise zero is returned and the error flag ( 

by ferror(fp)) is cleared to allow further 

No attempt is made to remove the source 



ferror(fp) - Return the last error on a file. 

•This function returns EOF if the file pointer (fp) is 
invalid. Otherwise the DOS error code left shifted eight 
bits is returned. The DOS error codes are described in the 
technical section of your DOS manual. 



read(fp* buf* n) - Read bytes. 



This function attempts to read 



bytes from the file 



denoted by the file pointer "fp" into the buffer at address 
"buf". The function returns the number of bytes actually 
transferred to the buffer. If no bytes were transferred 
then is returned to indicate end of file or -1 is 
returned to indicate an error. When this function returns 



a number different than 
return either or 
data has been read. 



i" the next read on the file will 
-1 to indicate the reason why no more 



This is a binary read* .there are no translations 
performed on the input stream (ie. carriage-return is not 
translated to , \n f ). 



See also 



wr i t e (f p* buf * 
clearerr ( f p) . 



n) 



feof(fp)* ferror(fp) and 
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setstackO - Set the maximum stack size required. 

The default stack size for Intersoft C programs is 
1024 bytes. If more is needed then write the function: 

y* The stack size desired */ 
^define STACKSZ 2048 

int ccst kmg; 
set stack O 

ccstkmg = STACKSZ; 

compile it with the "-g" option, and link it with your 
program. The free memory pool resides between the end of 
the program in memory and the top of the stack. Failure to 
set the stack size appropriately will result in dynamically 
allocated storage being overwritten. Please note that the 
I/O support functions use dynamic memory allocation when 
opening files (even the standard input, output and error 
files). 



sysmsg(ptr) - Write a message to the console. 

This function calls the DOS to write the NUL (zero) 
terminated string at address "ptr" directly to the system 
console. It is typically used for special errors which 
prevent the use of the standard error file (stderr) (ie. 
Reporting an i/o error on the standard error file). 



write(fp, buf, n) -Write bytes 

This function attempts to write "n M bytes to the file 
denoted by the file pointer "fp" from the buffer at address 
"buf". The function returns the number of bytes actually 
written to the file. A returned value other than "n" 
indicates an error of some sort. This is a binary write, 
there are no translations performed on the output stream ( 
ie- *\n' is NOT translated to a carriage-return). 



See also; 



read(f p, 
c learerr ( f p) 



buf, n), feof(fp), ferror(fp) and 
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EXTRACT 

The "extract" program allows the operator to extract one or 
more modules from one or more source librarys. This module 
would then be customized* compiled* assembled and added to a new 
library or linked with a program before clib/rel. To use the 
extract program simply type its name. The program will prompt 
you for the source library nameCs)/ module name(s) and output 
file nameCs). Entering a null line in response to the "Module 
name ?" query will cause the program to stop extracting modules 
and ask for a new source library. Entering a null line in 
response to the "Library name ?" query will cause the program to 
te rmi na te. 



SPLIT AND MERGE 

The "split" and 
library is to be 
under the control of 
i ndi vidua I files f 
"merge" program will 
The average Inters 
programs* they have 
because they were 
Programmer's manual. 

The "split" pr 
component modules* 
modules in the sourc 



"merge" programs 
compiled and as 
one "00" file. T 

or each module 
create a "00" fil 

oft C user wi 1 1 
been included o 
used as example 

ogram splits a 

produci ng a file 
e library. To use 



are used when a source 
sembled as separate modules 
he "split" program makes 
in the source library* the 
e to process the modules, 
never need to use these 
n the distribution disks 
s of C programs in the 

source library into its 
containing the names of the 
this program type: 



split <library >names 

where "library" is the name of the source library to be split 
and "names" is the name of the file to contain the names of the 
modules. The program also produces one output file per module 
in the source library (these files are created on drive :0 if 
they do not already exist). These names of these output files 
are the names of the modules in the library. 

Next the operator is expected to make a template of the 

"DO" file to process one module* except put a percent <%) 

character everywhere that the module name would normally be. An 
example is: 



C % o=%/MAC -G -N F=1 
KILL % 
M80 V. = % 
KILL %/MAC 

the "merge" program uses this template file and the list of 
names of modules produced by the "split" program to produce a 
larger "DO" file which will process each of the modules in 
turn. 
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Split/ Merge and Extract 



If the output of the split orogram was: 



merge" program (with the sample 



M001 
M0D2 

then the output of the 
template) would be: 

C M0D1 o=M001/MAC -G -N F=1 

KILL M001 

M80 M0D1=M0D1 

KILL M001/MAC 

C M0D2 o=M0D2/MAC -6 -N F=1 

KILL M002 

M80 M002=MOD2 

KILL M0D2/MAC 

To use the "merge" program type: 
merge template <names >output 

where "template" is the name of the template file* "names" is the 
name of the file containing the module names and "output" is the 
name of the output "00" file. 
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INTRODUCTION 

"C" is a general purpose programming lanouaqe suitable for 
solving a large class of oroqramming problems. It is not a 
particularly "high" level language* nor is it particularly "bio" 
in that it does not support a great many control structures. C 
is a language carefully designed to be a good balance between 
the concepts that programmers think in terms of and the current 
capabilities of computers. The fact that computers are becoming 
faster and more powerful has aided the soread of the C lanquaie 
throughout most classes of computers. 

C was originally desianed by Dennis Ritchie for the UNIX 
operating system to run on a DEC PDP-11. Since that time the C 
language has migrated to mainframe computers (Honeywell 6000 
series and IBM 370)* to other minicomputers (Interdata ft/ 3?) and 
to microcomputers (CP/M* FLFX and TRS80). 

An excellent reference to the C programming language is 
"The C Programming Lanquage" by Brian W. Kernighan and Dennis • v *. 
Ritchie published by Prentice-Hall (ISBM 0-13-110163-3), 
available in soft-cover. The book contains a tutorial on 
programming in C* a description of standard C functions* a 
description of the UNIX operating system interface to C and a C 
reference manual. On the minus side* the book was published in 
1978 so it is somewhat out of date with respect to the latest 
UNIX conventions. 

The purpose of this manual is to describe Intersoft C* a 
subset of the C described in the book by Kernighan and Ritchie. 

Intersoft C is based on "Small-C" written by Ron Cain* 
published in "Dr. Dobbs Journal of Comouter Calisthenics 9 < 
Orthodontia" in 19 80. Intersoft has made a great number of 
modifications and enhancements to Mr. Cain's compiler in order 
to support a larger subset of the C language and increase 
performance. 

Another manual (the Implementation manual) will accompany 
the compiler itself. The Implementation manual outlines the 
implementation specifics of your version of the Intersoft C 
c ompi I e r . 

An editor is required to oreDare C programs for 
compilation; one is not included with the compiler. An an aid 
to owners of uppercase only or otherwise restricted keyboards 
the Intersoft C compiler is case insensitive when recognizing 
keywords. The comoiler also recoanizes escaoe sequences for 
characters which your keyboard may not contain: 



(* is equivalent to i 

$) i s equi valent to > 

( . is equi valent to C 

.) is equi va lent to 1 

* : is equi valent to ! 

* * is eoui valent to 

*s> i s equi va lent to 



(Curly brace) 
(Curly brace) 
(Square bracket) 
(Square bracket) 
(Or bar ) 
(Ti Ide) 
(Caret ) 
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In addition to an editor you will also need an assembler to 
assemble the outout of the C comoiler. D ossible assemblers are 
listed in the ordering information. Tntersoft does not 
guarantee that any assemblers other than those listed will be 
able to assemble the output of the comoiler. 
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REFERENCE GUIDE 

A terse reference quide to Intersoft C v2.5 is given later 
in the manual. For a comprehensive introduction to C Dlease 
refer to the tutorial in the book by Kernighan and Ritchie 
mentioned in the introduction. 



The Basic Components of the C Languaqe 

Every C oroqram is composed of qlobal data and a number of 
functions which may call each other or themselves. These 
functions may contain local data which is allocated from the 
machine's stack upon each entry to the function and exists only 
until the ^function returns to the calling function. Every 
program must include a function with the name "main"; this is 
where execution beqins. When the "main" function is exited the 
program terminates* closing all open files. 



The Preprocessor 

The compiler preprocesses all programs before compiling 
them. The primary functions of the preprocessor are: 



1) 



2) 
3) 

5) 



Skip all comments in the program. All text enclosed by 

"/*" and "*/" (except where the "/*" or "*/" occurs within 

a string constant) is considered to be a comment. 

Allow the use of unparamet er i zed macros. 

Allow the inclusion of other source files. 

Allow conditional compilation. 

Allow the inclusion of assembler code. 



The preprocessor will be described in detail later on in this 
section of the manual. For now it is only important to know 
that all text enclosed by /* and */ constitutes a comment. 



Declaring Data 



supports two basic data types* "char" and 
variables are eight bit unsigned integers* 
for storing characters. "int" variables are 

sixteen bit signed integers* typically used for storino counters 

andthelike. 



I ntersoft C 
"int". "char" 
t ypi ca 1 1 y used 
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In addition to the two basic tyDes/ pointers to the basic 
tyoes and single dimensional arrays of the basic tyDes are 
suoported. Roth of these data types must be declared in terms 
of one of the basic types (Fg. pointer to "char" or array of 
"int"). The more advanced data types defined in the C languaae 
such as "structs"/ "unions"/ "typedefs"/ multi-dimensional 
arrays^ "floats" and "longs" are not yet supported by Intersoft 
C. 

Intersoft C does not support "casts". Data type conversion 
is performed automatically by the compiler as required. When 
converting an eiqht bit value to a sixteen bit value the 
original eight bit value becomes the lower eight bits of the 
sixteen bit value/ the upper eiqht bits of the sixteen bit value 
are set to zero. When converting a sixteen bit value to an 
eight bit value only the lower eight bits of the sixteen bit 
value are used/ the uooer eight bits of the sixteen bit value 
are di sea rded. 

Variable names are comoosed of alphanumeric characters and 
the underscore. The first character in a variable name must be 
either alphabetic or the underscore. The Intersoft C compiler 
is case sensitive for local variables. The first eight 
characters in local variable names are significant. The number 
of significant characters in global variables (or function 
names) is dictated by the assembler to be used? the 
Implementation manual will qive this value. Since most 
assemblers are not case sensitive all global variables are 
turned into uppercase by the compiler. Your assembler may place 
further restrictions on global variable names. For example some 
assemblers do not allow register names to be used as variable 
names. 

Some examples of data declarations: 



char c 7 
char *p 



/* Define a character variable named "c" */ 

P 1 



char car ray r.8 + 21 ; /* Define an array of 10 characters */ 

/* named "carray" */ 

char c / *p/ 

car rav r8+2i; /* define all three data items at once. */ 



/* Define an inteqer named 



*/ 



int i J 

int *p; /* Define "p" as a pointer-to-inteqer */ 

int iarrayT8+?i; /* Define an array of integers "iarray" */ 
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int i * *p* 

iarrayC£+2l; /* define all three data items at once. */ 



Expressions 

An "expression" is a phrase in the C language which yields 
a numeric value. Simple constants or variables are expressions/ 
as are constants and variables combined via "operators" (Eg. a + 
3). 

A special suh-class of expressions refer to manioulable 
pieces of storage. Elements of this sub-class are called 
"Iva lue"(s) by Kernighan and Ritchie. Their specialty arises 
from the fact that only lvalues may be the target of an 
assignment via the assignment operators or the "♦+" or "--" 
operators. The simplest form of an lvalue is a variable. 
Another example is *3 which refers to the 16 bits of storage at 
address 3. Addresses are not lvalues* pointers may be lvalues. 



Constant s 



char 

hex i 
dec i 
zero 
Hexi 

"OX" 
dec i 

char 
A c 
es ca 
back 
have 
sect 
outl 



The 
ac te 

Num 
dec i 
ma I. 

(Eg 

dec i 
<Eg 

ma I 
C p 

ac t e 

ha ra 

pe 

si as 
any 

i on 

in es 



re are 
r and 
eric c 
ma I • 

Oct 
. 010 
ma I c 

. Oxin 

10! ). 
rov i de 
r s in 
c te r 
charac 
h (\) 
ch ar a 
title 
the e 



three different types of constants* numeric* 
string, 
onstants may be either decimal* octal or 

The default base for numeric constants is 
al constants are always written with a oreceeding 
is octal 10 or decimal 8; NOT decimal 10'). 
onstants are always written with a leading "Ox" or 

Cor 0X103 is hexidecimal 10 or decimal 16; NOT 

s the ability to include certain non-qraohic 
character or string constants by "escaping" them. 
is "escaped" by immediately preceeding it with the 
ter. The escape character is normally the 
however it is possible (via the "esc=" option) to 
cter be considered the escape character (see the 
d "How to Use the Compiler"). The following table 
scape sequences supported by Intersoft C. 



newline N L ( R S ) \nor\N 

horizontal tab HT \tor\T 

backspace 9S \b or \R 

carriage return CR \r or \R 

f rm feed FF \f or \F 

backslash \ \\ 

s i ng le quote ' > * 

any bit pattern ddd Nddd 



The escape seauence Nddd contains one* two or three octal 
diaits which are taken to be the numeric value for the escaped 
character. Within strinas the double quote character " is 
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escaped via the escape sequence \ " . Tt is also possible to 
split a long string constant across more than one line by ending 
the line with a backslash (\)* inside a string constant both the 
backslash and the following newline character will be ignored. 
As a final note be warned that if the compiler finds a backslash 
which is not part of any escape seauence it can decipher the 
backslash will be removed from the constant or string 1 

PLEASE NOTE that the newline character C\n') is actually 
RS (record separator* value 30) not LF (linefeed* value 10). We 
have found it necessary to redefine the newline character due to 
differences in how end of line is handled by different ODerating 
systems. 



charac 
value 
charac 
S 
es cape 
va lue 
locat i 
stores 
• \0' ). 



haracter constants consist of a single (or escaped) 
ter surrounded by aoostroDhes (single auotes *). The 

of a character constant is the numeric, value of the 
ter between the aoostroohes. 

trine constants consist of a sequence of characters (or 
d characters) surrounded by quotes (double quotes "). The 
of a string constant is the address of the first memory 
on that contains the string constant. When the compiler 

strinq constants it appends an ascii NUL character ( 



Operator s 



Ope rator s are 
mani pul a ted. C ha 
operators* unary 
operators and the co 

Each operator h 
are exe cut ed first. 

* c " . Because mu 
addition "b" will 
be added to "a". If 
woul d expect t hat 
multiplied by "c". 
evaluation through 
expression is surrou 
unit before its 
pa rent he ses < Eg. a 
multiply "a" by the 

The operands o 
from left to ri gh 
eval ua t ed from le f 
uses the " + + " or " — 
express i on. As a r 
an express i on if the 
variable. For exa 

* p t r + 1" is indete 
" * p t r + + " is evalua 
"*ptr++ = *ptr + 1". 
determinate since ea 



special symbols which cause 
s five classes of operato 

operators* binary operators 
mma ooerator. 

as a "priority"* higher priori 

An example of this is the expr 

Itiplication has a higher pr 

be multiplied by "c" and then th 

addition had a higher "priorit 

"a" would be added to "b"* th 

It is possible to alter the norm 

the use of parentheses " 

nded by parentheses it is eva 

value is used by operators 

* (b + c) will add "b" an 
result). 

f operators are not necessar 
t. Mor are sub-expressions 
t to right. This can cause or 
" operators to cause side effect 
ule it is safe to use a variable 

"++" or "--" operators are use 
mple the result of the express 
rminate since it is not gua 
ted first. Another indetermina 

The expression " * p t r 1 + + = 
ch variable only occurs once. 



data to be 
rs? prima ry 
* ass i g nment 

ty operators 
ess ion "a + b 
iority than 
e result will 
y" then one 
en the result 
al orde r of 
()". If an 
luated as a 
outs i de the 



i ly eva I ua t ed 

neces s ar i ly 

oblems i f one 

s within an 

once on ly in 
d with that 
ion "*otr++ + 
ranteed that 
te examp le is 

*ptr2++" is 
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Primary operators 

Primary operators have the highest priority. 

Intersoft C currently supports the O and CI primary 

operators. They are used for function callinq and array 
indexing resoec t i ve I y • 

Further E xampl e s: 



i nt a# b* array tAD ; 

fred(a/ b); • /* Calls function "fred" with arguments */ 
/* "a" and "b". */ 



S(a, b) ; 



/* Calls the function at address 5 with */ 



/* ar qument s 



and "b". */ 



a rr ay f 33 ; 



/* Gets the fourth element of "array" */ 



Unary Operators 

Unary ooerators have higher priority than any binary 
operator but lower priority than any primary operator. All 
unary operators have the same priority. A list of the 
unary ope rator s i s: 



- The indirection operator 

This ooerator is used to qet a value from memory 
qiven a pointer to the memory address you want. Eg: 



char *cot r * zi 

cptr = 0x1090; 
c = *cpt r ; 
*cpt r = c + 1; 



Will qet the character from address 1000 (Hex)* 
assign it to the character "c H » increment it then 
store it back into address 1000 (HEX). If the "*" 
operator is used with a non-pointer then the type 
returned is always "int". All data items are 
converted to 16-bit inteqers if indirection is used 
more than once. "**cptr" refers to an integer even if 
"cotr" is declared to be a pointer to a character. 
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- The "address of" operator 

This onerator returns the address of an object. 
The "object" must have an address (must be an 
"lvalue"). R6 and ?,(a+b) are illegal. Eg: 



char c* *cptr/' 
cotr = Sc; 



Will qet the address of "c" and assign it to the 
character pointer "cotr". 



- The unary minus operator. 

This operator negates its operand/ Eg: 
negates "x". 



-x 



- The logical negation ooerator. 

The result of applying this operator is 1 if its 
operand was zero* otherwise the result is 0. Eg: 



int ** y? 

x = 3; 
y = !x; 



Assigns the value n to "y" 



- The one's complement operator. 

The result of aoplyinq this operator is the one's 

complement of its operand. The one's complement is 

obtained by reversing the sense of each bit in the 

operand. The bit pattern 10101O1Q would be changed to 
01010101 by applying this ooerator. 



++ - The pre- or oos t- i nc rement operator. 

The p re-i nc remen t operator increments its operand 
before fetching it for use in the remainder of the 
expression. The po st -i nc remen t ooerator increments 
its operand after fetching it for use in the remainder 
of the exoression. The operand must be an "lvalue"/ 
the result of the exoression is not an "lvalue". Eg: 
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i nt a# b 



, c; 



a = ?; 

b = ++a; 
c = a++; 



Assigns the value 3 to "b M and "c" and leaves the 
value of "a" at 4. 



- The pre- or dos t-dec rement ooerator. 

These ooerators behave exactly as the ++ 
operators mentioned above with the exception that the 
-- operators decrement their operand. 



Binary Operator s 

Binary operators reouire two operands. The codinq 

format is "operandi ooerator operand?". All binary 

operators have lower priority than the unary ooerators. 
The following table shows the priorities of the binary 

operators in decreasina order* operators on the same line 
have the same priority. 



+ 
>> 

< 

% 

\ 

&R 
I 1 
*> • 



<< 
> 

I s 



< = 



> = 



Descriptions of the binary operators 



* - The multiplication operator 



/ - The division operator. 
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- The modulo (remainder) ooerator. 

The result of applying this operator is the 

remainder after division* Fq. 13 3 10 is 3. The 

formal definition is that (a/b)*b-a = a%b where a and 
b are inteoers. 



+ - The addition operator 



- The subtraction operator. 



>> - The riqht shift operator. 

The result of this ooerator when applied to "a >> 
b" is M a" being shifted right by "b" bits. "b" may be 
negative* in which case "a" is shifted left the 
appropriate number of bits. bits are shifted into 
t he va lue. 



<< - The left shift operator. 



The result of this operator when applied to "a << 
b" is "a" beinq shifted left by "b" bits. "b" may be 
negative* in which case "a" is shifted riqht the 
appropriate number of bits. bits are shifted into 
the value. 



< - The "less than" ooerator. 

"a < b" yields 1 if "a" is less than "b"* 
otherwise it yields 3 • 



> - The "greater than" ooerator. 

"a > b" yields 1 if "a" is greater than "b"* 
otherwise it yields 0. 



<= - The "less than or equal to" operator 



"a <= b" yields 1 if "a" is less than or equal to 
"b"* otherwise it yields 0. 
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>= - The "greater than or eoual to" operator. 



"a >= b" yields 1 if "a" 
to "b"/ otherwise it yields 0. 



is greater than or equal 



- The "equal to" oDerator. 

» a == b" yields 1 if 
otherwise it yields 0. 



i s equa I to 



!= - The "not eoual to" operator. 

"a != b" yield 
othe rwi se it yields 



"a != b" yields 1 if "a" is not eoual to 



- The arithmetic "and" ODerator. 

The result of aoplyinq this operator is a bitwise 
/»NDing of the operands. Eg. ANDinq the bit patterns 
10101010 and 110011O0 yields 10001000. 



- The arithmetic "exclusive' or" operator. 

The result of applying this operator is a bitwise 
exclusive ORing of the operands. Fg. exclusive ORing 
the bit patterns 10101010 and 11001100 yields 
01100110. 



I - The arithmetic "or" operator. 

The result of aoplyinq this operator is a bitwise 
ORing of the operands. Fg. ORing the bit patterns 
10101010 and 1100110O yields 11101110. 



RS - The logical "and" operator. 

The result of applying this operator is the value 
of the right operand if the value of the left operand 
is non-zero/ otherwise the result is zero and the 
right operand is not evaluated. This definition is 
slightly different from that given in the book by 
Kernighan and Ritchie* they define the result of 
applying this operator as 1 if both the operands are 
non-zero. The Intersoft definition does not guarantee 
a result of 1 but it does guarantee a non-zero result 
if both the operands are non-zero. 
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- The loqical "or" operator. 



The result of aoolyinq this operator is the value 
of the left ODerand if it is non-zero (in which case 
the right ooerand is not evaluated)* otherwise the 
result is the value of the riqht operand. This 

definition is slightly different from that aiven in 
the book by Kerniahan and Ritchie* they define the 
result of applyinq this operator as 1 if either of the 
operands are non-zero. The Intersoft definition does 
not guarantee a result of 1 but it does guarantee a 
non-zero result if either of the operands are 

non-zero. 



- The conditional ooerator. 

This ooerator is special in that it takes three 
operands even though it is classified as a binary 
operator. The form is "operandi ? operand? : 
operandi". Operandi is always evaluated. If it is 
non-zero then operand? is evaluated and is the result 
of the expression* otherwise ooerand3 is evaluated and 
is the result of the expression. 



Assignment Operators 

The assignment operators are a special class of binary 
operators. These operators cause the value of their left 
operand to be changed. All these operators have lower 
priority than any other binary operator (except the comma 
operator 1 ) and all assignment operators have the same 
priority. 



- Simple assignment. 

This operator causes the value of its left 
operand to be chanoed to the value of its right 
ooerand. The left operand must be assignable* Eg: 3=4 
is illegal but *3 = 4 is legal. The first example 
attempts to assign to the constant M 3 M * the second 
example assiqns to the contents of memory at address 
3. 



+=, -=, *=, /=, %=, >>=, <<=, &=, 

- Special assignment 



! = 



The expression "a <op>= b M 
equi va lent to 
"a = (a) <oo> (b)" where <op> is any 



oper at or s 



%, >>, <<, %, 



i s f unct i ona I ly 



of 
o r 



t he 
I. 



b ina ry 
However 



these constructs generate more efficient code since 
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the operand 



is evaluated only once. This may seem 



a picky point when assiqnino a value to a simple 
variable* but consider the savinq when assiqninq to an 
object that may be reached only via indirection. Eg: 

* (*( *(pt r+a) +b )+c) *= 2* 

i s equi val ent to: 

*(*( *<ptr+a> +b) +c) = *(*(*(otr+a)+b)+c) * 27 

The savinqs in bytes of code qenerated/ execution time 
and ease of codinq is siqnificant. 



The Comma Operator 

The. comma operator has the lowest priority of all 
operators. The form of an expression usino the comma 
operator is "a* b" where "a" and "b" are expressions. The 
result of the operator is the value of expression "b". The 
comma operator is not valid within a function call arqument 
list unless it is Surrounded by parentheses. Eq: f red(a/ ( 
i=3, i+4)# c). In this example the value of the second 
arqument to "fred" is 7. The most useful place for the 
comma operator is in the "for" statement to allow more than 

be initialized or changed in the 
incrementation portions of the 



one variable 
i ni t i a I i z at i on 
s ta tement . 



to 
or 



Constant Expressions 

Constant expressions are a special subclass of 
expressions. A constant expression is an expression containina 
only numerical or character constants/ possibly combined with 
operators. Valid operators for constant expressions are: 



Bi nary : 



% 



~, » 



<< 



> = 



< = 



# — # 



!=, S, \ 



Unary: -# 
Ternary: ? : 



Exoloitinq Constant Foldinq: 

The compiler will evaluate constant sub-exD res s i ons at 
compile time whenever it can (producinq smaller and faster 
code). There are two methods to improve the compiler's ability 
to evaluate constant sub-expressions at compile time: 
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1) Place constant sub- expressions within brackets (" <" and " V ) . 

2) Place constant sub-expressions at the beainninq of expressions 
involving both constants and variables. 

Examples of constant foldinq: 

3+7+i; 

i +3 + 7; 

i + ( 3 + 7 ) ; 

In the first and third examples the compiler will calculate the 
value of 3+7 at compile t i me , and qenerate code to calculate 
i +10 ins tead of i +3 + 7. 



S t atemen t s 

The simplest form of a statement in C is an expression 
followed by a semi-colon. This form of statement is used quite 
frequently to assiqn values to variables and to perform function 
calls. A semicolon by itself is a valid null statement. The 
null statement is typically used to satisfy the syntactic rules 
of C when the program does not need a statement in a location 
which must have a statement. 

Another form of a statement is a series of statements 
surrounded by curly braces "O". This compound statement is 
similar to the BEGIN. ..END structure of Pascal. Compound 
statements are used to structure blocks of statements within 
functions^ loops and conditional structures. 



if ( <e xp ressi on>) <statement> 

The "if" structure is a conditional which causes 
"<s tatement>" to be executed if "<expr ess i on>" is 
non-ze ro. Eq : 



int f I ag* a# b 

if (flag) 
a = b; 



Will execute "a = b" if "flag" is non-zero 
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if (<exoress ion>) <s ta te roent 1 > else <statement?> 

The "if. ..else" structure is a conditional which 

causes "<s t at emen t 1 >" to be executed if "<exp re s si on> " is 
non-zero/ otherwise " <s t a t emen t 2>" is executed. An "else" 
clause always refers to the most recent "if" statement. 
Note that if "<s ta temen t1 >" or "< s ta t ement?>" a re simple 
statements then they must be terminated by semi-colons. 
Eq: 



int a * b* c? 

i f (b < c) 

a = b; 
else 

a - c ; 



Will execute "a = b" if "b' 
otherwise "a = c" will be executed. 



is less than 



C 



for (<expr ess i on1 > ?<expressi on?>; <expressi on^» <statement> 



st 



The "for 
s ta tement . 
to the "for" 
counters. "<e 
evaluated each 
long as "<exp 
executed. "<ex 
"<stat ement>" 
evaluated. A c 
"<expression1>" 
opt i onal. Omi t 
loop. Eq: 



structure is a very general 
exor essi on1 >" is evaluate 
atement. A common use 
xoression?>" is the test 
time before "<s ta temen t>" 
ression2>" is non-zero "<s 
pression3>" is evaluated 
is executed but before 
ommon use is to increment c 
"<expressi on2>" and "< 
ting "<expr ess i on?>" will c 



purpose looping 

d once/ upon entry 

is to i ni t i al i ze 

condi t ion* it is 

is e xecut ed. As 

t atement >" will be 

each t ime after 

<exp res si on2 > is 

ounters. Each of 

express i on3>" are 

r eate an i nf in i te 



int i, arraytMAXIMDEXl; 

for (i = 0; i < viAXINDEX; arrayCi+ + l 



= en ; 



for (i = 0; i < MAXINDEX; i + O 
array Ci 1 - H; 

for ( ; ; ) C 

wait for stuff ( ) ; 
dostuf f o; 

> 



The first and second examples initialize "array" to 
contain zeroes. The third example loops forever calling 
functions "wa i t f o rs t uf f " and "dostuff". 
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while (<expres sion>) <statement> 

The "while" construct executes "<s t atement >" as lonq 
as "<exDression>" is non-zero. The test to see if 
"<expr ess ion>" is non-zero occurs before "<s ta t ement >" is 
exe cut ed. Eg : 

char *ot r ? 

ptr = "Hi there cutie"? 
while ( * p t r ) 

processchar(*otr++); 



The example calls the function "processchar" with each 
character of the strina "Hi there cutie" in succession but 
not the • \ ' string terminator. 



do <statement> while ( <express i on>) ; 

The "do. ..while" structure is a looping construct 
similar to the "while" structure except that "<e xpres s ion>" 
is tested after "<statement>" is executed. Eg: 



char *cpt r; 

do I 

*cpt r = get c har(); 
> while (*CDtr++ != • \n*}," 

*cotr = null; 



The example reads a line of characters/ including the 
end of line character ( , \n , )# from the standard input file 
into the string " cotr". 



switch t<expr>) <statement> 



case < const ant ,exor> : 



de fau 1 1 : 

The "switch" structure is a multi-way "if". 

"<s t at ement>" is a compound statement in which some of the 

sub-statements contain labels of the form: 



case <constant . exor> : 
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i nt i » j * k; 



swi tch (i ) i 
c ase i 
c ase -1 : 
j = i ; 
break ; 



/* If "i" is or -1 then "i" is assigned to "j " */ 



/* Fxit the switch structure! *./ 



case 32767 ; 
k = i ; 

case 10000 : 
putdec (k ) ; 
break ; 



/* If i is 32767 then */ 



/ * Assi gn 



to 



and fall through to the */ 



/* next ca se ! */ 

/* If i was originally 10000 (or 32767) then */ 

/* Print "k" on the standard output file */ 

/* Fxit the switch structure! */ 



default : 
k = o; 



/* If 



was neither 0/ -1 / 32767 nor 10000 *! 



I * then as si on to 



and leave the switch */ 



break? 



The "break" statement terminates the execution of the 
smallest enclosing "for"/ "while"/ "do. ..while" or 
"switch". The next statement executed is the first 
statement following the "terminated" statement. The 
"break" statement is valid only within these statements. 
Egs 
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for ( ; ; ) { 
waitO/' 
rlostuffC); 
i f (done) 
b reak P 



In the above example 
n on -zero the infinite "for" 



when the va r iabl e 
loop is terminated. 



'done 



is 



cont mue# 



The "continue" statement causes proaram execution to 
be transferred to the next iteration of a "for", "while" or 
"do. ..while" Loop. "continue" is eauivalent to a "aoto" 
whose target is after the last executable statement in the 
loop but is still inside the loop. Mote: Intersoft C does 
not support the "aoto" construct, its mention was for 
i 1 1 ust rat ion on ly . Eq: 



for (;; ) < 

if (IwaitO) 

cont i nue? 
dostuf f o ; 

> 



/* If waitO failed then re-looo */ 



for <;;) < 

if (IwaitO) 

goto cont i n ; 
dostuf f ( ) ; 
c ont i n : 

> 



/* This is equivalent to 
/* example. Intersoft C 
/* SUPPORT the "qoto" */ 



the previous 
DOES NOT */ 



*/ 



re 



turn <expression> 7 



The return statement causes proaram execution to be 
transferred back to the calling function. If "<ex ores s ion>" 
is present then a single integer value may be returned, 
"<express ion>" is not mandatory. It is not necessary to 
put a "return" statement at the end of a function unless a 
value is to be returned, functions return automatically 
after executina their last statement. 
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Funct i ons 

To declare a function one writes its name/ a list of its 
arguments surrounded by brackets then the tyDes of its 
arguments. A sinqle simple or compound statement composes the 
function. If local variables are reouired they must be defined 
before any statements are written. Eg: 



ma x (a / b) 
int a* b7 



if (a > b) 
re turn a? 

el se 

return b ; 



/* The argument list declares the calling */ 

/* seouence. Arguments must also be */ 

/* declared before the body of the function! */ 

/* A compound statement */ 



ma x ( a # b ) 
int a/ b? 
return (a > b) ? a 



b; /* A simple statement */ 



lonqpauseC ) 
i 

int i f i 7 



/* No arguments */ 

/* A compound statement */ 

/* Loca I va ri abl es */ 



for (i = 0; i < 32767; ++i) 
for (] = o; ] < 3? 76 7; + + j> ; 



A function call is an expression. It is possible to call a 
function by its address rather than by its name* or to call 
computed addresses. Eg: 



int fptr* a# b # i ? 



f unc ( a f b) ? 
f pt r = f unc J 
fptr(a# b) ; 
i = fptr (a/ b) ; 

<0xf n (a) ; 



/* Call "func"# discard the return value */ 

/* Get the address of the function */ 

/* Call "func"/ discard the return value */ 

/* Uses the return value */ 

/* Call a function at address Oxff */ 
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The Preorocessor Re-visited 

All C programs are preorocessed before they are compiled. 
The preprocessor changes lonq strings of whitesDace characters 
into single spaces and skiDS comments. A comment is defined as 
all text between enclosing "/*" and "*/" symbols. Comments are 

not nestable. 

In addition to these basic functions there are several 
preprocessor commands which ere very useful to programmers. All 
preprocessor commands must be written with the hash symbol (») 
in column 1 of the source file. 



Ma c ros 

It is possible to declare unpa rame te ri 2 ed macros throuoh 
the use of the ^define preorocessor command. The format of this 
comman d is: 

^define <identifier> <token string> 

"<i dent if ier>" is any valid identifier (variable name)* it 
is the name of the macro. "<token string>" is any string of 
printable ascii text including whitespace ud to the end of the 
source line. From the statement following the macro definition 
onward whenever "< i dent i f ie r>" occurs in the source file it will 
be replaced by "<token strinq>". It is possible to use an 
unparamet er i zed macro in the definition of another 
unpar ama t er i zed macro. The ability to define unpar amet e ri zed 
macros is useful since it lets programmers define symbolic names 
for constants at the too of a module and use the constants 
throuohout the module. 



Inclusion of other Source files 

It is possible to instruct the oreprocessor to switch inout 
from the current source file to some other specified file. When 
the other file has been compiled the preprocessor automatically 
switches back to the old source file. There are two forms of 
this d i rec t i ve : 



^include "filename" 

or 

^include <filename> 



In both cases filename must be a valid file name to your 
operating syst em. 
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Conditional Compilation 

The preprocessor has several 
facilitate conditional coiddi lation. 



nestable 



const ruct s 



to 



#ifdef<identifier> 

Will check to see if "<i dent i f i e r>" has been defined 
via "//define". If so then the code following the "Mfdef" 
will be compiled until the corresponding "tfelse" or 

"#endif" is encountered. If "<i dent i f i er>" wasn't defined 
then no code will be compiled until the corresponding 
"tfelse" or "tfendif" is encountered. 



#ifndef <identifier> 

Is similar to the "tfifdef" construct but will generate 
the code following it if " <i dent i f i e r >" is not defined. 



#e Ise 

This is the "else" clause for either the "ffifdef" or 
"tfifndef" constructs. It is optional. 



tfendif 



This ter-ninates a "#i fdef " or "ffifndef" construct 
i s mandat ory. 



It 



Fx ampl e 1 : 

^define FLAG1 

/Hfdef FLAG1 

printf ("FLAG1 is defined\n")7 
#endif 



E xampl e 2 : 

flifndef FLAG1 

printf ("FLAG1 is not defined\n"); 
tfendif 
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E xampl e 3 : 

/* This examole prints a message to tell whether or 
* not FL*G1 is defined. 
*/ 
tfifdef PLAG1 

Drintf ("FLAG1 is definedW); 
fie I se 

prinff("FLAG1 is not defined\n M >; 
#enrt i f 



E x amp le A : 

/* This example also prints a message to tell whether 
* or not FLAG1 is defined. 
*/ 
tfifndef FL*G1 

printf( M FLAG1 is not defined\n M ); 
#e Ise 

print f ("FLAG1 is def i n ed\n " ) ; 
tfenriif 



E xample 5 : 

/* This example prints a message to tell whether 

* or not FLAG1 and FLAG? are defined. It illustrates 

* the ability to nest the conditional compilation directives, 
*/ 

ffifdef FLAG1 
flifdef FLAG? 

printf ("FLAG1 is defined, FLAG? is de f i ned\n" ) ; 
#e Ise 

orintf ("FLAG1 is defined, FLAG? is not de f ine d\n M ) ; 
flendif 
#e Ise 
tfifrtef FLAG? 

print f ("FLAG1 is not defined, FLAG2 is de f ine d\n"} ; 
tfelse 

orintf ("FLAG1 is not defined, FLAG? is not de f i ned \n" ) ; 
tfendif 
#endi f 



Inclusion of Assembly Code 



It is possible to include assembly code in C programs via 
the "//asm" and "ffendasm" oreprocessor commands. Text between 
the "Sasm" and "#endasm M directives is copied directly to the 
assembler output file. No "^define" macro substitution, source 
file inclusion or conditional compilation is possible within a 
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"#asm" construct. The details of how to write assembly code to 
interface with C code will be explained in the Implementation 
manual for your compiler. It is not exDlained here because the 
details differ for different machine architectures. 

The ability to put assembly code within a higher level 
language program is useful in time critical situations or when 
the program must interface to software written in another 
language. 
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I/O IN C 



to three default files (more 

as needed). These files are the 

files. The default files are 

C program is executed and are 

function returns or when 

The default files are all 



This section deals with performing i/o in the C languaqe. 
C contains no built-in i/o facilities. I/O is performed via 
run-time support functions. An entire section of this manual ( 
titled "Run Time Supoort Functions") is dedicated to providing a 
quick reference to the suDPort functions included with the 
compiler. I/O functions are only one class of the suoDlied 
f unc t i on s. 

Every C proqram has access 
files may be opened and closed 
standard input* output and error 
opened automatically before a 
closed automatically when the "main 1 
the function "exit" is called, 
character oriented ascii text files. 

The standard input file may only be read. This file 
corresponds to buffered console input unless reassigned. To 
reassign the standard input file type "<filename" on the command 
line ("filename" is the name of the file or device to be used as 
the standard input file). 

The standard outDut file may only be written. This file 
corresponds to output on the system console unless reassigned. 
To reassign the standard output file type ">filename" or 
">>filename" on the command line. ">filename" specifies that 
"filename" will be created and written (or re-written* if the 
file already existed). ">>filename" specifies that the standard 
output file of the program will be appended to "filename". 

The standard error file corresponds to the system console 
and may not be reassigned via the command line. This file is 
normally used for messages which should always be written to the 
system c onsol e. 

All files are accessed via their file pointer* which is a 
variable of the type pointer to "FILE" or a constant. "FILE" is 
an unpa ramate ri zed macro defined to be "int" for this release* 
it may change in future releases so it is prudent to define file 
pointers to be of type Dointer to "FILE". The file pointers 
(sometimes referred to as "unit" numbers) for the default files 
are constants with the followina names: 



i nput file 
output file - 
error file 



- "stdin" or "STDIN" 
stdout" or "STOOUT" 

- "stderr" or "STr>ERP" 



- »» 



The constants "FILF"* "stdin"/ etc. are defined in a file 
provided with the compiler. Please refer to the I mol ement at i on 
manual for the name of the constant file for your machine. 



None of the i/o routines are guaranteed to be re-entrant* 
they access global data and make calls to the operating system. 
Programmers wishing to perform i/o from interrupt handlers are 
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advised to be cautious 



aetcharO and putcharO 



aetcharO and out 
from the standard i 
f i le. T he funct ion qe 
next character f rom 
upon end of file (or a 
1 6-bi t i nt eger/ . not 
value returned by q 
variable and later c 
N E V F R be ecual. The f 
character to be wri 
EOF uoon an i/o error. 

A simple examo I e 
i nout file to t he s 
is the c opy orogram 
Programs") is: 



charO are 
nput file 
tcharO t ak 
the standar 
n i/o *rr 
an a-bit c 
et char O ( 
ompare s it 
unction nut 
1 1 en ) and 

of a prog 
tandard out 
qi ven in 



two simple functions to read 
and write to the standard output 
es no arguments* it returns the 
d inout file or the constant EOF 
or). The constant EOF is a 
haracter. If a program puts the 
or putcharO) into an 8-bit 
to the constant EOF the two will 
char(c) takes one argument (the 
returns the character written or 

ram that copies the standard 
put file (a more complex examole 
the section titled "SamDle C 



ma in( ) { 
int i ' 

while ((i = getcharO) != EOF') 
putchar(i) * 



ge ts ( ) a nd put s( ) 



I 
I ar ger 
s t anda 
it in 
a st r 
EOF up 
string 
t e r m i n 
addres 
that c 
i s : 



t is frequently more convenient to perform i/o in blocks 
than a single character. "getsCsV reads a line from the 
rd input file (to the first newline character) and stores 
the string at address "s" (appending a 'XO* (ascii NUL) as 
ing terminator). The function returns the address "s" or 
on end of file or an i/o error. "outs(s) M writes the 



to the standard output file 



The s tr i ng 



at address n i 

ator ('NO') is not written. The function returns the 
s "s" upon success or EOF upon failure. A simole orogram 
opies the standard inDut file to the standard output file 
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ma i n ( ) { 

char I i ne H51 21 / 

wh i I e (get s ( I i ne ) 

puts(line)? 
put c har ( ' \ n' ) ? 



!= EOF) <: 



getdecO and outdecO 

Th*se functions convert integers (8-bit "char" or 16-bit 
"int" tyoes) from their binary form to ascii. "get dec O** takes 
no arnuments and returns an integer* the result of reading and 
converting an ascii strina like M -3nQ" or M 2". "out d e c ( n )" 
converts the integer "n" to ascii and writes it to the standard 
i nDut file- E xamole : 



ma in ( ) { 

char I i ne C51 21 7 
int i ? 

putsC'Please enter an integer ? M ) ; 

i = getdecO? 

out s ("The integer was ") ? 

out dec ( i ) J 

puts("\n'M; 



e r ror ( ) 

M error(s/t)" writes the strings at the addresses "s" and 
"t" to the standard error file* then exits the proqram closing 
all open f i I es . 



Ex ampl e 1 : 

char *f name ; 

errorf" Can't open file "* fnameK 
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E x amp I e 2 : 

ma in ( a rq c # a rg v) 
int ar qc/ *a rqv? 

i nt n? 

/* . 



*/ 

error (" Illegal option ", aravCnl); 



E xampl e 3 : 

/* This example shows a null string as the second argument */ 
error( M Insufficient memory"/ "")J 



Opening and Closinq Additional Text Files 

The function "f ooen ( f na me/ mode ) " attempts to open a file 
and returns the file pointer for the file or zero if the file 
could not be opened. "fname" is the address of a string 
containing the name of the file to be opened. "mode" is the 
address of a string indicating how the file is to be accessed: 



or 
or 
or 



"R" - 
"W" - 
"A" - 



Read only 
Write only 
Append only 



Exampl e : 

/* This opens "fname" for aooend or kills the program */ 
openapp( f name) 

char * f name# 
i 

FILE *fp; 

fp = fopenCfname/ "a")? 
if ( ! fp) 

errorC'Can't open"/ fname); 
return f p; 



The function "c kope n ( f n ame /mode) " takes the same arguments 
as the function "fopen" but always returns the file pointer of 
an open file. If the file could not be opened the error messaoe 
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"Can't open <file>" is written (<fite> is the string at address 

"fname") and the Drooram is exited* ctosinq all open files. The 

following examDle will either ooen the file "file" for read 
access or exit the program: 



FILF *fp; 

fp = ckooenCfi le% M r") 



The function " f c I os e ( f d ) " closes the file associated with 
the file pointer "fp". The function returns non-zero upon 
success or zero uoon failure. The following example opens then 
closes a file called "file": 



fclose(fopen("f i le", "w")K 



I/O, with non-Default Files 

The functions getcharO, putcharO/ getsO* PutsO* 
getdecO and outdecO have equivalents which perform the same 
functions and return the same values but take an additional 
aroument/ the file pointer of the file to be accessed: 



get char ( ) 
putchar( c) 
ge t s (s ) 
puts ( s) 
getdec ( ) 
putdec (rO 



get c (f o) 
put c(c/fp) 
f get s ( s# f p) 
f put s( s* f p) 
get nuii ( f p) 
put num (n# f p) 



unget c O 

The function "ungetc (c/f p)" unreads a single character "c" 
from the file "fo". Only one character may be unread at % a 
t i me. 



feof O 

The function "feof(fp)' 
been reached on the file 
open file. 



returns non-zero if end of file has 
fp" or if "fo" does not represent an 
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Formatted I/O 
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I/O with Bi nary Files 

The run time support library currently contains no 
functions to support i /o with binary files. If these functions 
are required they may be written and added to the run time 
support library or kept in a library of your own. The interface 
to binary files is defined in chapter eiqht of the book by 
Kerniqhan and Ritchie. The most useful functions would be 
openO* close()* readO/ writeO and seekO. 
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THE C0*!*4Nr> LINE 

It is possible to oass information to your C programs via 

the command line which invokes the proqram. The Intersoft run 

time support provides C programs with a tokenized copy of the 

command line if it is desired. To qet at the copy of the 
command line from C programs all that you need to do is declare 

the "main" function of a program to have two arguments* as 
follows: 



ma in (a rgc/ arq v) 
int arac/ arqv? 

<: 

/* The body of the main procedure */ 
> 



"a rgc" is a count of t 
string of non-wh i t esoa ce cha 
including the name of the pr 
to an array of pointers to s 
individual tokens from the 
them. We declare it to be an i 
not supDort the data type ooint 

According to UNIX conven 
string containing the name 
Unfortunately some micro-comp 
name of the program very hard 
argvCOl contains a pointer to a 

Some examples of programs 
information from the operator a 
"Sample C Programs". 



he number of 
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og ram itself, 
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command line* 
nteger because 
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tok ens (a token i s a 
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Please refer to the cooy command in the section titled 
"Sample C Programs" for an example of the uses of i /o 

re-direction. 
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Sample C Proq r am$ 



SAMPLE C PPOGPWS 

Please note that all listings in this section are of the 
CP/|w versions of these oroarams. The format of the file names 
in the ^include directives may be different for your system. 



The Standard Header File 

The followinq is a listing of the standard i /o header 
file. It illustrates how constants can be qrouDed toqether via 
the "^define" preorocessor command. 



/* 

* The Intersoft C V?.5 standard i /o definitions 

*/ 
//define NULL 
^define FORMFEED 1? 
#define TRUE -1 
tfdefine FALSE 



#def i ne 
#def ine 
#def i ne 
#def ine 
//define 
#def i ne 
#def ine 
#def i ne 
#def i ne 
#def i ne 



FILE int 

EOL 30 
EOS 

EOF -1 



STDIN 
STDOUT 
STDERP 
s tdi n 
s tdout 
stderr 
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A Prooram to Split Source Libraries 



he Ip 
like 

each 
mark 
by 

unt i 
The 

proc 

ex am 
s t r i 
same 
the 



The 
ma 

nor 
mo 
. T 
this 
I it 
sour 

Thi 
esse 

Tak 

pi e 

ngs. 

ef 

s t r i 



fol 

i nt a 
ma I 
dul e 
he r 
pr 
i s 
ce I 
s pr 

d; s 

e sp 
of 
It 
feet 
nq s 



lowi nq I 
in sourc 
C proqra 
is mar 
ema i nder 
oq ram. 
SDlit.be 
i brary m 
oqram i 
ee the f 
ec i a I no 
a very 
i s poss 
* but 
qe nerate 



i s t i 
e li 

ms • 
ked 

of 

A 
ca us 
ay b 
Uus 
unct 
te o 
ef 
ible 
us in 
s mo 



nq i 
brar 

The 
wi th 
that 
sour 
e of 
e in 
trat 
i on 
f th 
f i ci 

to 
9 t 
re e 



s of 
i es • 
di ff 
a I i 
I i ne 
ce I i 
thes 
any 
es h 
"main 
e f u 
ent 
use a 
he + + 
f f ici 



a pro 
Sour 
e renc 
ne be 
i s t 
brary 
e mod 
I anqu 

ow c o 

ft 

• 

nc t i o 
way 
r ray 
and 
ent c 



gram used at Intersoft to 
ce libraries look very much 
e is that the beginning of 
ginning with an exclamation 
aken to be the module name 
will not compile correctly 
ule marking source lines, 
age. 
mmand line arguments may be 

n "amatch"/ it gives an 
o* sequentially Drocessinq 
indexing to achieve the 
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* 
* 

*/ 



This program splits a source library 
modules. It also produces a list of 
in the library that was just split. 

Copyright (c) 1982 by Intersoft 

by: Richard B. Mc^urray 



up i nto indi vi dua I 

the names of the modules 



# i nc lude <s tdi o.h> 



^define LJNELEN 130 
^define MERGECH '%• 
^define MAXtfODS 10H 

char lineTLINELENl; 
FILE *infile, 

*out file? 
int modulesCMAXMODST, 

nmods 7 



I * A source line */ 

/• The input file pointer */ 

/* The outDut file oointer */ 

/* Addresses of the strings containing */ 

/* the module names */ 

/* The number of modules */ 



ma in ( a rqc # arg v) 
int arqc/ *a rgv? 

int i ; 
char c I 



/* Verify the number of arguments* initialize data */ 
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if (a rgc > 1 ) 

us aq e O ; 
out file - nmods = 0; 

/* Skip lines in the source library until a module marker 
* or end of file is encountered 

while (notnewf i le ( )) ; 

/* Loop until a module marker is not encountered */ 
for (;*l ine == ' ! • ;> i 

/* Open a newoutout module* closing the old one */ 
openout t ) 7 

/* Cooy a portion of the source library (to the next module 
* marker) into the outout module 
*/ 
while (notnewfileO) i 
f put s ( I i ne/ ou tf i I e) ; 
Dutc('\n'/ out file); 
> 



/* Write the list of module names* one per line */ 
for (i = 0; i < nmods? ++i ) i 

puts (modul esCi ] ) ; 

putchar ( • Nn 1 ) ; 
> 



/* This function prints the USAGE message and exits. */ 
us age ( ) i 

Duts("USAGE: split <infile >name I i s t \ n") ; 

exi t (1 ) ; 
> 



/* This function oerforms an anchored string match. */ 

/* M s M is assumed to be as long as or longer than "t". */ 

amat ch (s * t ) 

cha r * s* *t ; 
i 

while (*t &* *s++ == *t++); 

return ! *t ; 
> 



/* 



* This function reads a line from the input library* 

* returning zero if the line specifies a new file* 
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* otherwise non-zero is returned, 
*/ 
notnewf i le O 

return (qets(line) != FOF II * I i n e ) S ^ *line != 



• i « 



Thi 
the 
i s 
the 



/* 

• 

* 

* 

*/ 

openou 

if ( 

fc 

modu 

out f 

> 



s function closes the current output fite and opens 
new output file. The name of the new output file 

stored in the array "modules" for use later when 
control file to orocess the modules is created. 

t() < 

ou t f i le) 

lose ( out file)? 

lesCnmods++1 = s t r sa ve (S I i n eC1 1 ) ? 

ile = ckopenCSli nefn, "w") ; 



* This function saves a strinq dynamically and returns 

* the address of the saved cooy. 
*/ 

st rsaveC s) 

char * s ; 
i 

char *p7 



if (p = a I loc( str I en(s ) + 1)) 

strcpy(p/ s ) ? 
return p; 
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A Merne Proqra m 

The followinq program takes a template file containinq the 
character *'£ % where it exDects a file name to be filled in, and 
the list of file names produced by the previous proqram. This 
program copies the template file once for each file name/ 
substituting the file name for the '%• every time it occurs in 
the temolate file. These copies of the template file are 
concatenated toaether into the standard outDut file. 

This program is used to create a command file to orocess 
each of the modules extracted from a source library by the 
"sDlit" program. 



/* 

* This program creates a control file to process each of 

* the output modules of the split program according to 

* a specified template. 
* 

* Copyright (c) 1982 by Intersoft 
• 

* by: Richard B. ^c^urray 
*/ 

#i nc I ude <s tdi o.h> 

fldefine LINFLEN 130 
^define MFRGFCH % % % 
^define TAPCH 9 



char I inerLINELENl, 

repcha rJ 
int mergefile? 



/ * A source I i ne */ 

/* The replacement character */ 

/* The template file unit number */ 



ma in ( a rg c# arov) 

int arqc/ *arqvJ 
i 

char +startbuf* *endbuf* *otr* *bsize? 

int c J 



/* Parse the command line */ 

if (argc < ? 11 argc > 3 11 »(mergefile = f ope n(a rgvH 11 * w r M >)) 
iisaoe ( ) 7 

repchar = MFRGHCH; 
if (argc == 3) 



if ( ! amat c h C ar gv Z?l * 



)) 



us age ( ) 7 
else 

repchar = f e t c he h ( a rgv C?3 , ?)7 
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/* Read the temolate file into a memory buffer 

* Trailing whitesDace is stripped from all lines of 

* the template file. The temolate file is terminated 

* by either EOF or by the first non-pr i n t abl e » 

* non-wh i tespace character. 
*/ 

bs i ze = meml ef t ( ) 1 

if (!(startbuf = a 1 1 oc (bs i ze) ) ) <. 
putsC" Insufficient meniory!\n w ); 
e x i t ( 1 ) ; 
> 

endbuf = s ta rtbuf '» 
ptr = startbuf - 1? 
while ( ( c = qetc(merqefile)) ,= F.0F) { 

if ((c >= ' • W c <= •"*) II c == TABCH) C 
if (endbuf >= startbuf + bsize) i 

put s (" Insuf f i c i ent memory to save the template fileMn"); 
e x i t ( 1 ) ; 
> 
if (c != ' M5 c != TABCH) 

ptr = endbuf? 
*endbuf + + = c.7 
> else 

if ( C == 'XnM { 
*++ptr = • \n •; 
endbu-f = ot r + 1 ? 
} else 
break? 
> 

endbuf = ptr + 1 ; 
fclose(mergefi le) ? 

/* Read module names from the standard input file */ 
while (qets(line) != EOF) -C 

/* Module names must beqin with a printable non-space 

* c ha rac t er. 

*/ 
if < *line <= * ' II *line > •"•) 
break ; 



/* Copy the temolate file to the standard outout file* 
* replacing the "repchar" with the module name 
*/ 
for (ptr = startbuf^ ptr < endbu f J ptr + O -C 
if ( *pt r = r repchar) 

put s ( I i ne) * 
else 

put cha r (*Dt r ) ; 
> 
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/* This function Drints the HSAGF messaqe and exits. */ 

us age (X 

put s ("USAGE: merqe template r c=xl <infile >ou t f i I e V n" ) ; 

putsC* wakes n conies of template where n = ft of lines in infile\n" )? 

nutsC'Uses successive tines of infile to replace all i nst a nc e s\n") ; 

puts("of the merge character from the template file.W); 

e x i t ( 1 ) /" 



/* This function returns the n+1th character from a strinq 
f e tchc h ( s* n) 

char * s ? 

int n 7 

return slnl ' 



*/ 



/* This function performs an anchored strinq match. */ 



/* "s 



is ass 



umed to he as tonq as or lonqer than "t". */ 



amat ch ( s* t ) 

char *s/ *t? 
i 

while <*t &? *s + + == *t++): 

return ! * t ; 
> 
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Printf/ Fprintf and SoMntf 

The following listing is the header file for the orintf ()/ 
forintfC)/ sorintfC) and ecnutfC) functions from the Intersoft 
run time I i bra ry . 



/* 



* Definitions for printf/ forintf () and sprintfC) 
* 

* Copyright Cc) 198? by Intersoft 

* By : R • McMu r r ay 
* 

* Based on printfO by Mike Core. 
*/ 



#def i ne 


STRING 





#def ine 


NUMBER 


1 


#def i ne 


ZERO 


*n* 


#def i ne 


BLANK 


i i 


#def ine 


LEFT 





#def i ne 


RIGHT 


1 


#def i ne 


PLUS 


D 


#def ine 


MINUS 


1 


#def i ne 


MA XI NT 


32767 


#def i ne 


RUFSIZE 


16 


#def i ne 


WIDTH 


13? 



i nt c c na rg; 
int ccarq; 
char * ccbpt r 
c har *cc ept r 
int ccunout 
char *ccsadr 



/* Hold the number of arguments to printf */ 

/* Points to the first argument */ 

/* Typically* beginning of string pointer */ 

/* Typically/ end of string pointer */ 

/+ The output unit number* for sprintfC) */ 

/* The string address for sprintfC) */ 
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The following listing is a source library containinq four 
of the Intersoft run time support functions. Source tines 
beqinning with " ! " mark the beqinnina of a module. Note how the 
"Hasm" oreprocessor command is used to manipulate a variable 
number of arguments to these functions. 



/* 

* printfO* fprintfO* sorintfO and ccputfO - formatted output 

* 

* Copyright (c) 1 Q * '2 by Intersoft 
* 

* By : R • l*" c^u rr ay 
* 

* Based on printfO by fike Gore. 
*/ 

•PRINTF 

if i nc lude < s tdi o.h> 

^include "printf.h" 



printf () C 
/* 

* Alt of the arguments that are passed to printf 

* are pushed on the stack. The A register contains 

* the argument count. CCARG is the address of the 

* first argument on the stack. CCARG is the address 

* of the format string. 
*/ 

#asm 



; Save ft of arqs. in CCNARG. 

; Index by words not bytes. 

; Save address of pointer to 

; first argument . 



LD 


L,A 


LD 


>!,0 


LD 


(CCNARG) #HL 


ADD 


HL#HL 


ADD 


HL^SP 


LD 


(CCAR5)#HL 



#enda sm 

ccunout = stdout; 

ccsadr = 07 

ccDUt f ( ) ; 
> /* e nd printf */ 



/* Set the output unit */ 

/* Common formatted output routine */ 



! FPRINTF 

#i nc lude <stdi o.h> 

//include "printf.h 1 



f print f ( ) < 
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* 

* 
*/ 

#3Sm 



Alt of the arguments that are passed to fprintf 
are Pushed on the stack. The a reqister contains 
the argument count. CCARG is the address of the 
first argument on the stack. 
CCARG is the address of the file pointer. 



l_n 


L,A 


LD 


H,n 


DFC 


HL 


LD 


(CCNAPG*) #HL 


ADD 


HL,HL 


ADD 


HL*S p 


LD 


(CCARG),HL 


tfendasm 




ccunou t = * ( 


ccarq + ?/) * 


ccsadr = n; 




ccput f ( ) 7 


/* 


> /* end f pr in 


tf */ 



; Subtract file unit arg. 

; Save M of args in CCNARG. 

; Index by words not bytes. 

; Save address of pointer to 

; first ar gumen t . 

/* File pointer is the first arg. */ 

Common formatted output routine */ 



! S p PINTF 

//include <stdio.h> 

^include "orintf.h 



sprintf(){ 

/* _ 

* All of the arguments that are passed to sorintf 

* are pushed on the stack. The A register contains 

* the argument count. CCAPG is the address of the 

* first argument on the stack after the string address 

* CCARG is the address of the format string. 
*/ 

#3 sm 



LD 


L,« 


LD 


H,0 


DEC 


HL 


LD 


(CCNARG) ,HL 


ADD 


HL*HL 


ADD 


HL,SP 


LD 


(CCARG), HL 



Subt ract string 
Save # of arqs . 
Index by words 



pt r a rg. 
in CCNARG. 
not bytes. 



Save address of pointer to 
first argument . 



flenda sm 

ccsadr = * (c carq + 

ccunout = 0; 

ccputf o; 

ccpc h( 0) ; 
> /* end sprintf */ 



?>; 



/* Common formatted output 
/* Terminate the string */ 



routine */ 
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! C C P U T F 

include <s t d i o.h> 

^include "printf.h" 



cput f ( ) < 




int 


sign; 


/ * 


int 


ma sk ; 


/ * 


int 


nbi t s ; 


/ * 


int 


num; 


/ * 


int 


big; 


/ * 


int 


carry; 


/ * 


int 


t emn; 


/ * 


int 


flag; 


/ * 


int 


fir; 


7* 


int 


f mi n ; 


/ * 


int 


f max ; 


/ * 


int 


a len ; 


/ * 


int 


n; 


/ * 


int 


npad; 


/ * 


char 


f code; 


/ * 


char 


fiu; 


/ * 


int 


c oun t er ; 


/ * 


char 


* a rq ; 


/ * 


char 


• f mt ; 


/ * 


char 


buf CBUFSIZEi; 


/ * 



Siqn flag for X6 */ 

Mask for octal & hex numbers */ 

The number of bits in mask */ 



Unconverted # for 



u 



2d *o %h */ 



Assigned the value WAXINT */ 

Used in %u for carry */ 

Used in 2u */ 

Number / string flaq */ 

Left or right justify flag */ 

Minimum field width *7 

Maximum field width */ 

Length * / 

The length of a strinq * 7 

Number of pad chr chrs */ 

Holds current fmt chr *7 

Fill character *7 

Current argument number *7 

Pointer to current argument */ 

Pointer to the fmt control arg. 

Buffer for %c and numbers *7 



*7 



counte r = 1 ; 
fmt = ccargs (count er ) ; 

if (!fmt) 7* Check for missing control arg. *7 

return; 

for<;;> < 

cc bpt r = fmt ; 
cceptr = Oxffff; 

7* Output all non-format characters *7 
while ((fcode = *ccbptr) != T) < 

i f (fcode == EOS} 
return; 

ccpch(*c cbnt r + + ) ; ._ 
) 
fmt = ++ccbptr; 7* ^ove to next format character *7 

fir = RIGHT; /* Pioht justify by default *7 
if (*fmt == •-•> C 

fir = LEFT; 7* Left justify if specified *7 

++f mt ; 

> 



fill = BLANK; 7* Fill with blanks by default *7 
if (*fmt == «T) i 

fill = ZERO; 7* Fill with zeroes if specified *7 

++f mt ; 

> 
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fmin = ; f* Get min. field widths default is * / 
while ( i sd i qi t ( * fmt ) ) 

fmin = fmin * 10 + *fmt++ - 'D'? 
if (*fn»t == •. • ) 

+*fmt; 

fmax = 0; /* Get max. field width* default is WIDTH */ 
wh i I e ( i sd igi t ( * fmt ) ) 

fmax = fmax * 13 + *fmt++ - 'D 1 ; 
if (fmax == II fmax > WIDTHS 

fmax = WIDTH; 

arg = c caras (++c ount e r )7 /* Get arg, to print */ 

/* Select the aDDrooriate format */ 
switch (fcode = touppe r ( *f m t + + ) ) { 

/* Single character */ 
case f C ■ : 

flag = NU^ER; 

ccbptr = cceotr = buf + BUFSIZE; 

*--ccbptr = arg & O x ff; 

break; 

/* String */ 
case • S" : 

flag = string; 

if (!arg) 

arg - 
ccbptr = cceptr = arg; 

n = o; 

whi le (*cceptr 1 = EOS) 

+ + cc ept r ; 
break; 

/* Octal or Hex number */ 
case * 1 : 
case * X * : 

flag = NU^^ER; 
num = arg; 
if (fcode == '0'r-{ 
mask = 0x7; 
nbits = 3; 
> else < 

mask a Oxf ; 
nbits = A; 
> 

ccbptr = cceptr = buf + BUF SIZE; 
do C 



*--ccbotr = (num fc mask) + ((num % mask") < 10 ? 
060 : 0127); 
> while ((num >>= nbits) > 0); 
break ; 
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/* Signed decimal number */ 
case * D * : 

ftaq = number: 

num - arg; 

ccbptr = cceptr = buf + BUFST7E? 

s i on = (num < 0) 7 

do { 

temp « num T _ 1 0; 

i f (temD < 0) 
temp = -temD; 

*--ccbotr s •0' + te-DD? 

num 7= 10; 
> while (num); 
if (sign) 

*--ccbptr = *-*; 
break ' 

/* Unsigned Decimal number */ 
case *U* : 

flag = NUMBER; 
num = arg; 

ccbptr = cceptr = buf + BUFSIZE; 
if (num >= 0) 
do i 

*--ccbDtr = 9 1 + (num % 10); 
} wh i le ( (num /= 10) > 0) ; 
else { 

big = MAXINT; 
num = (num S- bid); 
ca rry = 1 ; 
do i 

terno = (num X 10) + (big * 10) + carry; 
carry s temp / 10; 
temp %= 10; 

*--ccbDtr = •0 I + temp; 
num /= 1 0; 
V while ( (bi g /= 10) > 0); 
> 
break ; 

/ * Unrecocmized format */ 
de f aul t : 

flag = STRING; 

cceptr s f mt ; 

fmax = width; 

fmin = 0; 

break; 
> /* end switch */ 

/* Enforce the maximum field width. */ 
if (ccbptr + fmax < cceptr) 
cceptr = ccbptr + fmax; 



/* Propagate minus sign to the front of a number padded */ 
/* with preceding zeroes. */ 



Inter sof t C v2 .5 



48 



Samp le C Pro ar ams 



if (*cchpt r == ' -' ** * i U 
cc pch ( *c cbot r + +) ; 

alen = cceotr - ccbptr; 
if (alen > f mi n) 

f m i n = a I en? 
npad = fmin - alen; 

if (fir == RIGHT) 
wh i le (npad-- > Q) 
c cpch ( f i 1 1 ) ? 

while (cceptr. > ccbptr) 
ccpch ( *c cbpt r + + ) ; 

if (ft r == LEFT) 

while (npad-- > 0) 
ccpch(fill); 
> /* end for(;;) */ 
> /* end ccput f */ 



= = ZERO &P, flaq == NUMBER) 



/* Compute the min. t* of */ 
/* characters to print */ 



/* Right justify */ 



/* Output the item */ 



/* Left justify */ 



/* Returns argument number z */ 
c c arqs ( 2 ) 

i nt z ? 

return (Iccnarq If z > ccnara) ? 



*(c carq - z - z + 2} 1 



/* Output a character */ 
ccoch(c) 

int c ; 
i 

if ( cc unout) 

put c ( c* cc unout ) 7 
el se 

*c csadr + + = c ' 
> 
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The followinq is a list inn of a simple Dronram that uses 
the i/o redirection capabilities of Intersoft C to become a 
useful copy program. The orooram copies the standard input file 
to the standard output file. Through the i/o redirection 
caoabilities of Intersoft C this program can be adapted to coDy 
files to or from virtually all devices on your computer. 



Possible uses of the Copy command: 

- The command "copy filel >file?" will copy "filel" to "file?". 

- The command "coDy filel >>file?" will aDpend "filel" to 
"file?" if Intersoft C for your micro suDports apnending to 
f i les. 

- The copy command can become a printer program by specifying 
file? to be the printer (list device). Oevice names are 
described in the I mo I e (rent at i on manual. 

- The command "copy filel" will list filel on the system 
conso I e . 

- The command "cooy >file1" will allow you to enter filel from 
the conso le. 

- The command "copy >>file1" will allow you to append to filel 
from the console if Intersoft C for your micro supports 
appending to files. 

Find out what the end of file character is for your micro 
before attempting to use the "copy" command to enter files from 
the system console. 



/* 

• 

* 

* 

#i 

ma 



Copy from standard input to standard outout, 
Copyright April 1<>81 by Intersoft Unlimited 
by Be rni e Roeh I 

/ 

nc I ude <s td i o. h> 

in(arqc/ argv) 
int arqc/ aravCl? 



int in# c 7 

i f (argc == 1 ) 

in = STDIN; 
el se 

in = ckopen(argvC1D/ "r"); 
while ((c = getc(in)) != EOF) 

putc(c/ STDOUT); 
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HOW TO USE THE COMPILER 

First create a C program using a suitable editor* then 
execute the compiler via the command: 

C <infile> Co= <out f i le>1 r*ootionsl 

where : 



<infile> - The input file name. 



o=<outfile> - The output file name. 

Some versions of the compiler will automatically 
create an output file with the same name as the input file 
but with a different file name extension. Please refer to 
the Implementation manual for the details concerning your 
machine. 

•options - Compiler options. Way be any (or none) of: 
-g - Do not define storage for global variables. 



Normally t 
g loba I va r i abl e 

One way o 
separately comp 
the g lobal va 
compi I ed. In t 
Pitchie the k 
dec I ar at i ons to 
t he comp i ler t 
program could t 
not cont a in a 
variable coul d 

I nte rsof t 
G I oba Is must 
ff i nc lude) in a I 
should be use 
t he prog ram t 
variables bein 
the globals is 
modul e with sto 



he compiler will allocate storage for all 
s defined in the module being cpmpiled. 
f structuring large programs is as several 
iled modules. The compiler reauires that 
riables be defined in each of the modules 
he C defined in the book by Kernighan and 
eyword "extern" causes global (or local) 
be defined for the compiler but instructs 

allocate no storage for these variables. A 
hen be structured so that modules which do 

given global variable but do access the 
define the variable as "extern". 
C does not support the "extern" keyword, 
be collected into one file and included (via 

1 modules for compilation. The "-g" option 
d on the compilation of all code modules of 
o prevent multiple copies of the global 
a allocated. Then the file containing all 
compiled without the "-g" option to create a 
rage for all the global variables. 
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-n - Do not Dass the number of arauments to functions. 

The comoiler will normally pass the number of 
arquments to each function every time it is called. This 
option prevents the compiler from qenerating code to pass 
the number of arquments to each function called. It is 
always preferable not to pass the number of arguments to a 
function. The run time support functions printfC)* 
fprintfO* sprintfO/ scanfO/ fscanfO and sscanfO 
require the number of arguments information. If your 
module uses one of these run time support functions then do 
not use this option. The default is to pass the number of 
arauments to. every function called. 

+s - Include the C source as comments in the output file. 

This option is occasionally useful during debugginq. 
The default is not to include the source code in the output 
f i le. 



lp=nn - Set the size of the literal pool (in bytes). 



The literal pool contains string 
emptied after each function is compiled. 



c onstant s. 1 1 is 
In the event t h at 



a function requires 
size this opt ion may 
diagnostic when the 
decimal/ hexidecimal 
default is 256 bytes. 



a literal oool larger than the default 

be used. The compiler produces a 

literal oool overflows. nn may be a 

or octal unsigned constant. The 



dp=nn - Set the size of the "^define" (macro) oool (in bytes). 

The "tfdefine" preprocessor command is explained in the 
section titled "Reference Guide". The compiler will 
Droduce a diaqnostic if the "^define" (or macro) pool 
overflows. "nn" may be a decimal* hexidecimal or octal 
unsianed constant. The default is 1200 bytes. 



#d=nn - Set the maximum number of "#define"s (macros). 



The "^define" preprocessor command is explained in the 
section titled "Reference Guide". The compiler will 
produce a diagnostic if a module contains too many 
"^define" statements. "nn" may be a decimal* hexidecimal 
or octal unsigned constant. The default is 100 
"#def ine"s. 
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#g = nn - Set the maximum number of global variables. 



The compiler will produce a diaqnostic 
contains too many c I oh a I variables. "nn" may 
hexidecimal or octal unsianed constant, 
global variables. 



i f a modu le 

be a dec ima 1/ 

The default is 160 



#l=nn - Set the maximum number of local variables. 

The compiler will produce a diaqnostic if a function 
contains too nanv local variables. "nn" may be a decimal/ 
hexidecimal or octal unsigned constant. The default is ^0 
local variables. 



ll=nn - Set the maximum length of a source line. 

This value is actually one greater than the maximum 
length of a source line* one byte of the line is reserved 
for a line terminator. "nn" may be a decimal* hexidecimal 
or octal unsigned constant. The default is 13? bytes. 



lab=nn - Set the first local label number. 

The C compiler generates local labels. If you are 
using the C compiler in- conjunction with a linking loader 
you newer need this option. If you do not have a linking 
loader then you should use this option in coniunction with 
the "stats=nn" option to insure that local labels do not 
overlap in a program that consists of several separately 
compiled modules. The default first label number is 5000. 



esc=c - Set the character escaoe character 



If your keyboard is not 
backslash <\) character then you 
character via this ootion. Eg: 
newline character* eouivalent to 
more on how to use escape characters refer to the section 
titled "Reference Guide". The default is '\'. 



capable of producino the 

may re-define the escape 

if "esc=*" then '*n* is the 

■ \ n • when "esc=\". For 



stats=nn - Print compiler statistics. 

If nn is non-zero then the compiler will display the 
first and last local label number used in the compilation. 

This option is of interest only to those who are using the 

compiler in conjunction with an assembler that does not 

have a linking loader. Also see the "lab=nn" option. The 
default is zero (no statistics). 



Intersoft C v?.5 S3 How to use the compiler 

f=nn - Generate size ootimized code for 78 n « s . 

This ODtion concerns only Z80 owners. If "nn" is one ( 
1) then the compiler will use reset vectors 6 and 7 to 
access commonly used run time support functions. This 
actually slows programs marginally but decreases the amount 
of code generated for a program. The default is zero (do 
not use reset vectors). 

NOTE: Reset vectors are 3&^ 
for TESDQS & LDOS 6 
But are 1&2 for NEW'DOS 
80 Ver 2„0 
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RU*J TIME SUPPORT FUNCTIONS 
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support library is included as a searchable 
o have linking loaders. Please refer to the 
al for the name of the library file and how 

the run time support libraries consists of 
e the Implementation manual for the names of 
file contains several functions. The 
rated bv lines starting with an exclamation 
ewer) letter name. These files constitute a 
urce library. Listings of two programs which 

of source library are given in the section 
Programs". The functions are ordered within 

function calls a function defined before 

to change any of the run time suoport 
ly suqgest that you make a library or module 
unctions and link it before searching the 
ther than actually changing the supplied 



The f o I lowi ng is a 
(in alphabetical order): 



list of the run time support functions 



abs(n) - Returns the absolute value of M n w . 



alloc(n) - Allocate dymamic storage. Also see free(p) 



This function attempts to allocate 



bytes of system 



memory for use by the program. 



is an unsigned integer ( 



ie. -1 = 6553S). The address of the memory is returned if 
the allocation succeeded* otherwise zero (0) is returned. 



atoi(s) - Returns the integer value of the string 



bound(v*l*u) - Perform a ranqe check. 



This function returns one (1) if "v" is greater than 
or equal to "I" AND less than or equal to "u"* otherwise 

"I" and 



zero (0) is returned. "v"# 
i nt eqer s. 



"u" are all s igned 
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calloc(n/Size) - Allocate dynamic storaqe. 

This function attempts to allocate sufficient system 
memory for M n" items each of "size" bytes. Both "n" and 
"size" are unsigned integers. The address of the memory is 
returned if the allocation succeeded/ otherwise zero (0) is 
returned. See also cfree(o). 



ccexitO - Exit program with no cleaning up. 

This function immediately exits a C program without 
closing open, files. It is eauivalent to the function 
exitO described in the C book by Kerninqhan and Ritchie. 



ccioinO - Initialize the i/o and support package. 

This function is called during the setup of the 
environment of every Intersoft C program. This function 




This function causes a considerable portion of the 
Intersoft run time support functions to be included with 
your program. It is possible to alter the run time 
environment of G programs by changing this function (eg. 
removing command line parsing* adding i/o re-direction of 
the standard error file* etc.). 



are using C to generate code for another 
should write your own ccioinO function and 
in your source. It will replace the one 
us when you link it with your program. This 
use the run time environment of your micro for 
of the software* then by including your 
ccioinO function you can reconfigure your program for its 
new environment. See also ccmainO and ccsetupO. 



If your 
machine you 
i nc lude i t 
supplied by 
will let you 
deve lopment 



ccmainO - Initial entry point of all C programs. 



This function performs any initialization required 
before C code may be executed (eg. In the CP/^l version this 
is where the stack pointer and the reset vectors are 
initialized) then jumps to the routine ccsetupO. See also 
ccsetupO and ccioinO. 
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ccsetupO - Set uP/ execute and terminate a C program. 

This function calls ccioinO to initialize the 
remainder of the C environment* then calls the main 
function of the C program "main(arqc* arqv)"/ then calls 
the exit function M exit(PV to terminate the program. See 
also ccmainO and ccioinO. 



cfree(p) - Deallocate dynamic storaqe. 

"p" is the address returned by c a 1 1 oc ( n*s i ze ) . 

ckopen (name*mode) - Ooen a file OR ELSF! 

This function will open the file "name" with mode 

"mode" and return a valid file Dointer or else it will 

print the message "Can't open <name>" and terminate the 
p roqram. 

cooyby te ( f rom/ to/numbe r) - Copy bytes. 

This function copies "number" bytes from the address 
"from" to the address "to". "number" is an unsigned 
i nt eger . 

error(szt) - Print an error message and exit. 

This function prints the two strings "s" and "t" to 
the standard error file/ then calls the exitO function to 

terminate the proqram. 

exit(n) - Terminate a C proqram* closinq all files. 

"n" is the program termination code. Zero (0) means 
normal termination. 



fclose(fp) - Close a file. 

This function attemots to close a file. It returns 

non-zero if the file is closed correctly. "fo" is the 

value returned by the fopenC) function for the file in 
auesti on. 
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feof(fp) - Check for end of file. 

This function returns non-zero if the file " f d ' 
reached end of file, otherwise zero (0) is returned. 



has 



fgets(s#fp) - Read a line from a file. 

This function reads a line from the file M fD M (to the 

first newline character) and puts it in the string "s". 

The address "s" is returned if the string was read 
correctly/ otherwise EOF is returned. 



findeos(s) - Find the end of a string. 

This function returns the address of 



the 



stnna 



f ooen( name/mode) - Open a file. 

This function opens the file "name" in the mode "mode" 
and returns a valid file pointer upon success or zero (0) 
upon failure. "name" is the file name as a string in the 
appropriate format for your operating system. "mode" is a 
string indicating how the file is to be accessed. Valid 



modes are 
a or 



o r 



R" for read 



or 



'W" for write and 



"A" for append. The maximum number of 
simultaneously ooen files is given in the Implementation 
manua I • 



f pri nt f ( f p/con t rol /a rg1 *arg?* .. .) - Formatted outDut. 

This function is similar to the printfO function. 
fprintfO performs the same operations as the printfO 
function except that it can operate on any file open with 
write or append access. "fp" is the file pointer Please 
refer to the printfO function for a description of the 
other arguments . 



fputs(szfp) - Write a string to a file. 

This function writes the string " s " to the file " f d" 

and returns the address "s" upon success or HOF uDon 
f ai lure. 
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free(p) - Deallocate dynamic storaqe. 

This function deallocates storaqe allocated by the 
function "alloc". "p" is the address returned by "alloc". 

f scanf (f p/cont rol*arg1 ,a ro2, ... ) - Formatted input. 

This function is similar to the scanf () function. 
This function performs the same operations as the scanfO 
function except that it acts on any file open with read 
access. "fp" is the file pointer. Please refer to the 
scanfO function for descriptions of the other arguments. 



getc(fp) - Get a text character from a file. 

This function returns the next character from the text 



file "fp". A sDecial newline character 



\n 



is ret ur ned 



upon end of line* and a special integer "EOF" is returned 
upon end of file or upon an i /o error. 



getcharO - Get a text character from the standard input file. 
This function is equivalent to "getc ( s tdi n )". 

getdecO - Get a decimal number from the standard input file. 
This function is equivalent to "getnum(stdin)". 

getnum(fp) - Get a decimal number from a text file. 

This function skips whitespace* then reads a string of 
six or less non-wh i t espac e characters and attemots to 
convert it to a decimal number. Conversion stops with the 
first non-digit. The number may be signed (either + or 
-). The converted integer is returned. 

gets(s) - Get a string from the standard input file. 

This function is equivalent to "f ge t s ( s*st di n)". 



i n i t by t e ( t o*va I /number ) - Initialize an array of bytes. 

This function assigns "val" to "number" bytes (8-bit 
items) from the address "to" onward. 
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i ni t word ( to/va l/number ) - Initialize an array of words. 

This function assigns "val" to "number" words (16-bit 
items) from the address "to" onward. r 



isatpha(c) - Test for alphabetic characters. 

This function returns one (1) if "c" is an alphabetic 
character/ otherwise zero (0) is returned. 



isdiqit(c) - Test for numeric characters. 



This function returns one (1) if 
digit/ otherwise zero (0) is returned. 



"c" is a decimal 



ishex(c) - Test for hexidecimal characters. 

This function returns one (1) if 
diqit/ otherwise zero (0) is returned. 



i s 



hexidecimal 



islower(c) - Test for lower case alphabetic characters. 

This function returns one (1) if "c" is a lower case 
alphabetic character/ otherwise zero (0) is returned. 



isoctal(c) - Test for octal digits. 



This function returns one (1) if 
digit# otherwise zero (0) is returned. 



is an oc t al 



isspace(c) - Test for whitespace characters. 

This function returns one (1) if " c " is a whitespace 
character/ otherwise zero (H) is returned. Whitesoace 
characters are soace/ tab and newline ('Xn 1 ). 



isupper(c) - Test for upper case alphabetic characters. 

This function returns one (1) if "c" is an upper case 
alphabetic character/ otherwise zero CO) is returned. 



itoa(n/s) - Convert an integer to an ascii string 



This function converts the integer 



into its ascii 



representation (with sign) and Duts it in the string "s". 
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ma x(a,b) - Return the maximum of two siqned integers. 

meminit() - Initialize the dynamic memory package. 

This function frees ALL allocated space and 
initializes the dynamic memory variables. This function 
should be used with GRFAT caution since not only will it 
deallocate all space allocated by a C proaram it will also 
deallocate the file control blocks and file buffers of all 
open files. 

memleftO - Return the size free memory. 

This function returns the number of bytes in the 
largest free memory block maintained by the dynamic memory 
package. The returned value is an unsianed integer. 

min(a/b) - Return the minimum of two signed integers. 



print f (control#arg1 ,arg2,... ) - Formatted output. 




max - This specifies the maximum length of the argument in 

characters. If there are more characters in the converted 
argument they will be chopped from the right. The default 
value of this field is 132. Setting the field to zero will 
also result in a maximum length of 132. <= max <= 32767. 



- This separates "max 
is not spec if ied. 



and 



mm' 



It is not required if "max 



min - The minimum width of the converted argument in characters. 
The default value of this field is zero. If the converted 
argument is less than the minimum width then the field will 
be padded according to the "-" and "0" arguments. 

- Specifies that the converted argument will be left justified, 
The default is right justification. 



- Specifies that zeroes will be used as 
default pad character is a space. 

A - The conversion character* one of 

S or s - indicates that the argument 



pad characters. The 



i s a st ring. 



Intersof t C v2. 5 



61 



Run Time Support Functions 



C or c - indicates that the argument is a character. 

D or d - indicates that the aroument is a decimal integer 

U or u - indicates that the argument is an unsigned 

decimat integer* 

X or x - indicates that the argument is a hex integer 

(The leading Ox is not printed). 

or o - indicates that the argument is an octal integer 

(The leadina is not printed). 



All but the •£• and the conversion character are optional in the 
conversion specification. 

Note that if no conversion character is found that 
everything in the control argument from the current •*'* 
character to the next , 7* character will be output with no 
soec i a I format t ing. 

In the following examples we have bracketed the 
formatted output with colons (:) to indicate where the 
output begins and ends. 



E xampl e 1 

printfChi > %30.10s", "hello world !\n">; 



prints 
:hi > 



he I lo worl : 



Examp I e 2 

printfChi > %30.10sW, "hello/ world !">; 



pr i nt s 
: hi > 



he I lo worl 



The newline is written since it was in the. control argument* 
not in the truncated portion of the string argument. 



Exampl e 3 

i nt a ' 

a = 123; 

printf (" + 7 u ,, # aK 

or i nt s 
:+123: 



E xampl e A 
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i nt a ; 

a = -1 ^ 

printf ("*010d", a); 

prints 

:-000000001: 



E xampl e 5 

char *s ; 

s = "hello"; 

printf ("?-10s",s> ; 

prints 

:he I lo : 



F xampl e 6 

printf ("%010s", "hi")? 

prints 
:00000000hi: 



x 



putc(c*fp) - Write a character to a text file. 

This function writes the character "c" to the file 
"fp" and returns "c" if the write was successful/ otherwise 
"EOF" is returned. 



putchar(c) - Write a character to the standard output file. 
This function is equivalent to "out c ( c #st dout )". 

putdec(n) - Write an inteaer to the standard output file. 

This function is equivalent to "putnum (n#s tdout ) " 



putnum(nzfp) - Write an inteqer to a text file. 

This function converts "n" to its ascii form (possibly 
siqned) and writes it to the file "fp". The last diqit of 
the number is returned upon success/ otherwise "EOF" is 
r et urned. 
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puts(s) - Write a strinq to the standard output file. 

This function is equivalent to " f out s ( s*s tdout ) 



scant ( cont rol *arg1 *a rg?# . . .) - Formatted input. 



The 
The cont r 
mus t mat 
which i nd 
store it 

argl * 
dat a i 
spe ci f i ca 
"argl", " 

Whit 
•\n«) cha 
argument 

When 
c onvers io 
strinq i 
character 
s canf ( ) 
a rqument s 

Scan 
mat ched. 
string* u 
file. If 

The 
where : 



"control" argument is the addr 
ol strinq contains nhitespace* 
ch the inout file and conversi 
icate how to convert data from the 
in the "arql"/ arg2" argumen 
a r g ? " arguments must be pointers t 
terns themselves. Each time 
tion is encountered it results in 
arg?" arguments being assigned, 
espace characters are the space* 
racters. All whitesoace character 
are ignored. 

a non-wh i te spa ce character 
n SDec if ic a t ion) is encountered 
t is expected to match the nex 

from the input file. Failure to 
to fail at that point and ret 

successfully matched. 
f() returns the number of argume 
It will return upon exhaust 
pon failing to match an argument* 

end of file is encountered scanf( 
format of a conversion specifi 



ess of a s t ri ng. 
char act er s wh i ch 
on spec i f i ca ti ons 
input file and 
ts. ALL of the 
o data* not the 
a conve rsi on 
the next of the 

tab and new I ine ( 
s in the control 

(not part of a 
in the cont rol 
t non-whi te space 
match will cause 
urn the number of 

nts success f ul ly 
ing the control 
or upon end of 
) returns EOF. 
cation is X*maxA 



* - An optional flag indicating that assignment is to 

be suppressed. If this flag is specified the data is 
read from the input file but not assigned to one of the 
"argl"* "arq2" arguments. 

max - The maximum field width. If this is specified the input 
file will be read until the end of the maximum field 
width or the next whitespace character. 

A - The conversion character* one of: 
D or d - A decimal integer. 
or o - An octal integer. 
X or x - A hexidecimal integer. 

H or h - A short integer (assigns to a character variable). 
C or c - An ascii character. 
S or s - An ascii string. The corresponding argument should 

be large enough to contain the string with a 

terminating , \0 < (NULL). 
One of the above must be present. 



Example 1 
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i n t i ; 

scanf('7H M , P< i > ; 
and the i nput I ine 

1000 
wilt assi an 1 000 to i 



Fxampl e 2 

i nt i /- ) p k ; 

scant("%2ri*2d%2d", Si, *i , Rk>; 

and the i nout line 

010101 

will assign 1 to i, j# and k. 



F xamp I e 3 

i n t i j ; 

scant ("*?d**2d%2d", Si, Kp; 

and the i nput line 

0102C3 

will assign 1 to i and 3 to j. 



Example A 

char aC30:j, bT30:i, cT3037 

s cant ("Xs^sXs"/ a, b, c); /* No mistake* the name ot an array */ 

/* reters to the address ot the array */ 
and the i nput I ine 
tee tie t oe ! 
will assign "tee" to a, "tie" to b and "toe!" to c. 



sprint t(ptr, control, arql ,arg2,. .. ) - Formatted output. 



This tunction is similar 
sprinttO pertorms the same 

tunction but operates on a string instead ot a 
is the address ot the string into which 
written. sprinttO assumes that the string is 
to hold t he out put. 



to the orintfO tunction. 

operations as the printfO 

tile. "ptr" 
the output is 
large enough 



sscanf (ptr/ControUarqUarq?^...) - Formatted input. 

This tunction is similar to the scanfO tunction. 
sscanfO pertorms the same operations as the scanfO 
tunction but operates on a string instead ot a tile. "ptr" 
is the address ot the string trom which the inout is read. 
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strcat(szt) - Concatenate strinq "t" to the end of strinq "s". 

*.'o check is made to verify that string "s M has enouqh 
storaae allocated to hold strinq "t" as well. 



strcmp(s/t) - Comnare strings. 

This function compares strinas character by 
character. Zero is returned if the strinas are identical. 
Otherwise the difference between the first oair of 
differinq characters is returned (ie. sfil - tfiT for the 
first i such that sCil != t T i 1 ) . Therefore if this 
function returns a negative number then the strinq "s" is 
less than the strinq "t". If this function returns a 
positive number then the strinq "s" is greater than the 
strinq "t". 



strcpy(s^t) - Copy strinq 



to strinq "s" 



No check is made to verify that strinq "s" is large 



enouqh to receive strinq "t M 



strinq(nzc) - Create and initialize a vector of bytes. 

This function allocates a vector of "n" bytes and 
initializes all elements of the vector to "c". "n" is an 
unsioned integer. 



strlen(s) - Return the lenqth of string 



system(s) - Execute a system command. 

This function is not suDported* it causes an error 
message to be displayed and execution to be terminated. 
"Attempted system call to <s>" 



tolower(c) - Returns the lower case value of **c 



touDper(c) - Returns the upper case value of "c". 



umax(a^b) - Returns the maximum of two unsigned integers, 
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umin(a*b> - Returns the minimum of two unsigned inteqers. 



umetc(c/fp) - Unread a character from a text file. 

This function returns the character "c" to the file 
corresponding to the file pointer "fp M so that w c" will be 
the next character read from the file. Only one "unread" 
character may be outstanding at any time for a given file. 
The character "c" is returned upon success/ otherwise EOF 
i s ret urned. 
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TE9SF RFFEPENCE GUIDE 

The following description is not intended to be riaorous. 
It provides a terse aeneral guide to the syntax of Intersoft C. 

Meta-symbols are enclosed in angle brackets/ the "::=" 
operator is used for "is defined as"/ Dossible values are listed 
on separate lines/ NULL means that it is legitimate to out 
nothing in that place. Whitespace is allowed wherever a space 
has been left between meta-symbols and/or terminal symbols. 
Square brackets "[]" have no significance other than as terminal 
symbol s. 



<dat a. or . f unc> : : = 
<data.def> 
< f unc . def > 



<data. de f > : : = 
<char.def> 
<int. def> 

<char . de f > : : = 

char <i dent i f i er. li st> 

<int .def > : := 

int <i den t i f i er . I is t> ; 



<i dent i f i er . I i st> :: s 
NULL 
<i dent i f i e r . I i s t. 2> 

identifier. list. 2> :: = 
<i dent .de f > 
<ident.def> # < iden t i f i e r. li st . ?> 

<i dent .def > : : = 

<identifier> 

*<i dent i f i er> 

<identifier> t <c on s tan t .e xpr> 1 

<i dent i f i er> : : = 
<al pha> 
<alpha><alphanum.list> 

<a lpha> : : = 

<"a" to M z"/ "A" to "Z" and underscore> 



<alphanum> ::= 

<All "<alpha>" characters and "0" to "<>"> 
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<f unc.def > : := 

<identifier> ( <name.list> ) <stmt> 

<identifier> ( <name.list> ) < <var.def> <stmt.list> > 

<name. Mst> : : = 
NULL 
<name. I i s t • 2> 

<name. I i st . ?> : : s 
< i dent i f i er> 
<identifier> #> <name . li s t . ?> 

<var .def > ::= 
MULL 

<char,def> <var.def> 
<int .def > <var . def > 




<stmt> 



<expr> ; 

break ; 

c on t i nue I 

case <constant . expr> 

default : <stmt > 



: <stmt> 



- Valid in loop or switch! 

- Valid on I y in loop! 

— Valid only in switch! 

— Valid only in switchl 



<s tmt . I i st > 
NULL 
<Strrt> 



<s tmt.l i St> 



<e xpr> : : = 

<pr i mary> 
* <expr> 



S <expr> 

- <expr> 

! <expr> 

* <expr> 

++< Iva lue> 

--< I va lue> 

< lvalue>++ 

< I va I ue>-- 

<expr> <binaryoo> <exor> 

<expr> ? <expr> : <exor> 

<lvalue> <asqn.op> <expr> 
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< p r i m a r y > : : = 

identifier > 

< constant > 

( <expr> ) 

<primary> ( <expr.list> ) 

<ptr.expr> £ <expr> 1 

<ptr.exor> : : = 

<A pointer expression or array name* see <expr>> 

< I va I ue> : : = 

<identifier> 
<ptr.expr> C.<expr>. 3 
* <expr> 
( <l value > ) 

<cons t an t . expr> ::= -- An expression involving cnly constants. 

<cons t an t> : : = 

<number . const > 
<character. cons t> 
<string. const> 

<numbe r. cons t> ::= — Values are all modulo 65576 

<decimal> — Format is iddddd (i > m (0 <= d <= 9) 
<octal> — Format is Oooooo (0 <= o <= 7) 
<hex> — Format is Hxhhhh (0 <= h <= F) 

<c haract er . const> ::= 

•<char.or.escapedchar>* 

<s tri ng. cons t> : : = 

"<char. or. escaped char. list >" 

<char.or ,es caoedchar .1 i s t> : : = 
NULL 
<char.or.escaoedchar> <char.or.escaoedchar. li s t > 

<c ha r. or . es capedcha r> ::= 

<Printable ascii and all escape characters 
defined in the section "How to program in C"> 

<expr. li st> : := NULL 
<expr. I i s t ,2> 

<expr . I i st .2> ::= 
<expr> 
<expr> / <expr . li st .2> 



<bi nar yop> : : = 

* 

/ 

X 

+ 
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>> 


<< 


< 


> 


< = 


> = 


= = 


« r 


& 


1 


8S 


1 1 


* 


<a sgnop> 


s 


+ = 


-- 


• s 


/ = 


•/ = 


>> = 


<<= 


&= 



1 = 



<preproc,essor> :: = 

^define <identifier> <t oken-s t r i ng> 

^include <<filename>> 

tfinctude "<f i lename>" 

#ifdef <i dent i f ier> 

tfifndef <identifier> 

#el se 

#endi f 

# a s m 

^enda sm 

Ptine <token-s t ri nq> -- Note: No effect on program! 
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COMPILER DIAGNOSTICS 

Constant reaui red/ 1 used 

Only constants are allowed. 

Constant reouired/ zero used 

Only constants are allowed. 

TFFAULT valid only in SWITCH 

A "default" statement was found outside a "switch" 
structure. Check the function's block structures. 

Global symbol table overflow 

The compiler ran out of space in the global symbol 
table. See the section titled "How to Use the Compiler" to 
find out how to define a larger global symbol table. 

Hex digit > F forced to F 

All numeric constants preceeded by "Ox" are assumed to 
be hexidecimal (base 1M* the digits are 0-9 and a-f. 

Illegal address with unary R 

The unary "%" operator may be used only to get the 
address of an item for which storage has been allocated. 
Example: "Sintval" is legal, "ROxff" is not. 

Illegal argument name 

Only simple symbol names may be used as argument 
names. 



Illegal function name or declaration 

Only simple symbol names may be used as function 
name s. 
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Illegal symbol name ignored 

I'sually caused by non-alohanumeric characters within a 
symbol name. 

Insufficient memory! 

Your machine does not have enouqh memory for the 
compiler to execute. Caused by overestimating the 
requirements for one of the compiler options or by t ry i no 
to compile large programs. SDlit the program into smaller 
compilation modules. 



Invalid expression* evaluated as FALSE 

Caused by a syntax error in an expression. 



Literal pool overflow 

The compiler has insufficient space to store the 
strinq and character constants. °lease refer to the 
section titled "How to Use the Compiler" to find how to 
expand the literal pool. The literal pool is written at 
the end of each function so estimate the required literal 
pool size by the requirements of the function with the most 
character and string constants. 



Local symbol table overflow 

See "Global symbol table overflow". This message 
refers to the symbol table which keeos track of variables 
which are local to a function. 



Lvalue not found 

The indicated item is not a unit of storage and 
therefore cannot have anything assigned to it. Note: "OxFF 
= 3" is illegal but "*0xFF = V is legal (it stores "S into 
memory location OxFF). 



Missing WHILE in DO. ..WHILE 

Either you forgot i t 
function is corrupted. 



or 



the block structure of the 
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hissing apostroohe in character constant inserted 

£ simple syyntax error, usually caused by not escaping 
an apostroohe in a character constant. 

Missing apostrophe, part of line not Dreprocessed 

A simple syyntax error, usually caused by not escaping 
an apostrophe in a character constant. 



Missing argument name 

The function has been called previously with more 
arguments than are present in the function definition. 



Missing brae ke t 

The language 
indicated col umn. 



requires an opening bracket at the 



Mi ssi ng colon 



The language requires a colon at the indicated 
column. 



Missing comma in argument list 

Arguments must be separated by commas. 

Missing open parenthesis 

The language requires an opening parenthesis at the 
indicated col umn. 



Missing quote inserted at end of line 

If you wish to extend a string beyond one line you 
must use the escape character as the last character in the 
line. 



No loops in effect 

The indicated construct is valid only within a loop 
st rue ture • 
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No loops or switches in effect 

The indicated construct is valid only within a loop or 
switch st ructure. 



Octal digit > 7 forced to 7 

All numeric constants beginning with zero 
to be in octal (base S) . 



are as sumed 



Preprocess buf f er . over f I ou/ line truncated 

Either the source line is very lonq or it contains 
macros which have lonq definitions. Please refer to the 
section titled "How to Use the Compiler" to find out how to 
specify that a longer source line be allowed. 



Semi colon missing 

The language requires a semicolon at the indicated 
column. It is also possible that previous errors in the 
source statement have overcome the compiler's error 
recovery abilities. Tf this is the case the compiler will 
produce these messages until the end of the statement is 
encount er ed. 



Symbol already defined 

The symbol has been defined previously 

Too many nested includes 

Too many nested looos and switches 

Unknown preprocessor command iqnored 

Unrecognized option 



Value too large* H377 used 

An escaoed constant within a character or string 
constant is too large. 
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Write er ror 



A write error has occurred on the output 
most common cause is insufficient disk space. 



file 



Th< 



Wrona tvoe or number of arquments 



Function argument definitions do 
araument list in the function declaration. 



not match the 



Intersoft C v2. 5 



76 



fhanqes from Intersoft C v?. n 



CHANGES FRO** INTERSOFT C V2.H 

The following features have been added to the lanquaqe. 
Descriptions of how to use them nay be found in the section of 
this manual containing the reference guide. 

1) Character escaoes (\n* etc.). 

2) The assignment operators (+=# -= r etc.). 

3) The logical AND and OR oDsrators {%%» M>. 

4) The conditional operator (?:). 

5) The comma operator (•). 

6) Conditional comoilation <#ifdef# tfifndef/ *e I se and tfendif). 

7) All keywords are case insensitive. 

8) Constant exoressions are allowed in array definitions and 
in the "case" statement. 

The compiler accepts special escape sequences for the 
characters < * >/■ C* 1 1# " and ~. See the section titled 
"Introduction". 

The command interface to the comoiler has been redesianed. 
The new command interface contains many new options. D lease 
refer to the section titled "How to Use the Compiler". 



Several new functions have been added to the run time 

meml e f t ()# 

sprintf ()/ 

t he se ct i on 

these new 



suDDort library. 
callocO/ cfreeO* 
scanf ( ) / sscanf O 
titled "Run time 
f unc t ions. 



alloc()# freeO/ meminitO/ 
feofO/ ungetcO/ fprintfO* 
and fscanfO. Please refer to 
support" for descriptions of 



The compiler diagnostics have been improved considerably. 
Please refer to the section titled "Comoiler Diagnostics". 

The compiler now generates better code. 

Limited constant folding has been added. 

A problem with using the "continue" statement within a 
"switch" statement has been corrected. 

The compiler now correctly scales values added to integer 
pointers. "iptr+3" would add three to the integer oointer 
"iptr" in version 2.?. Now this expression adds six so that 
"iptr" is adjusted to point to the third inteqer further on in 
memory. 



